Using Linkly with Claude Desktop

Connect Claude Desktop to your Linkly account and manage short links through natural conversation using the Linkly MCP Server.

What You Can Do

Once connected, you can ask Claude to:

  • Create short links - "Create a short link for https://example.com"
  • Track performance - "How many clicks did my links get this week?"
  • Manage links - "Update the link called 'promo' with a new destination"
  • View analytics - "Show me clicks by country for the last 30 days"
  • Search links - "Find all links related to the product launch"
  • Manage domains - "List my custom domains"
  • Set up webhooks - "Subscribe https://my-site.com/webhook to receive click events"
Shorten links using Claude Desktop
Shorten links using Claude Desktop

How to set up Claude Desktop with Linkly

1

Open Claude Desktop settings

Go to Settings (gear icon) → Developer → Edit Config to open your configuration file.

2

Add the Linkly MCP server configuration

Add the following to your config file. No API key needed — the hosted Linkly MCP server uses OAuth, so you'll sign in through your browser the first time you use it.

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}
3

Save and restart Claude Desktop

After saving the configuration file, restart Claude Desktop to apply the changes.

4

Sign in to Linkly

The first time you use a Linkly tool, a browser window opens asking you to sign in to Linkly and approve access. After that, Claude Desktop stays connected.

5

Verify the connection

Look for a hammer icon in the Claude Desktop input area. Click it to see available Linkly tools, or try asking "List my Linkly links".

More Information

For detailed documentation on available tools, link creation options, and troubleshooting, see the Linkly MCP Server documentation.

Claude Desktop Integration FAQs

"Could not connect to MCP server"

Confirm https://mcp.linklyhq.com is reachable from your machine and that Node.js v18 or later is installed (mcp-remote runs via npx). Try npx -y mcp-remote https://mcp.linklyhq.com in a terminal to see any errors.

"Authentication failed" or the browser keeps re-prompting

Quit Claude Desktop, delete the cached mcp-remote token in ~/.mcp-auth/, then restart Claude Desktop and let it re-run the OAuth flow.

Tools not appearing in Claude Desktop

Restart Claude Desktop after saving the configuration. Check that the JSON syntax in your config file is valid. The hammer icon should appear in the input area when properly configured.

What can I do with the Claude Desktop integration?

You can create, update, and delete links, view analytics and click data, search your links, manage custom domains, and set up webhooks - all through natural conversation with Claude. See the full list of tools.

Track 500 monthly clicks for free.

Get Started for Free

No credit card required

Enterprise — book a meeting