Using Linkly with Claude Desktop

Connect Claude Desktop to your Linkly account and manage short links through natural conversation.

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. Get your API credentials from Linkly

    Log in to your Linkly dashboard, go to Settings → API, and copy your API Key and Workspace ID.

  2. Open Claude Desktop settings

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

  3. Add the Linkly MCP server configuration

    Add the following to your config file, replacing the placeholder values with your actual credentials: {"mcpServers": {"linkly": {"command": "npx", "args": ["-y", "linkly-mcp-server"], "env": {"LINKLY_API_KEY": "your-api-key", "LINKLY_WORKSPACE_ID": "your-workspace-id"}}}}

  4. Save and restart Claude Desktop

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

  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".

Available Tools

Tool
Description
create_link
Create a new short link with optional UTM params, pixels, and more
update_link
Update an existing link's settings
delete_link
Delete a link
get_link
Get details of a specific link
list_links
List all links in your workspace
search_links
Search links by name, URL, or note
get_clicks
Get recent click data
get_analytics
Get time-series click data for charts
get_analytics_by
Get clicks grouped by country, browser, platform, etc.
list_domains
List your custom domains
list_webhooks
List workspace webhook subscriptions
subscribe_webhook
Subscribe a URL to receive click events
← Scroll →

When creating links, you can specify:

  • Basic: url, name, note, domain, slug, enabled
  • UTM Parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Open Graph: og_title, og_description, og_image
  • Tracking: fb_pixel_id, ga4_tag_id, gtm_id
  • Advanced: cloaking, forward_params, block_bots, hide_referrer
  • Expiry: expiry_datetime, expiry_destination

Claude Desktop Integration FAQs

"Could not connect to MCP server"

Check that your API key and Workspace ID are correct. Ensure you have Node.js installed (v18 or later). Try running npx linkly-mcp-server in a terminal to see any errors.

"Authentication failed"

Verify your API key in the Linkly dashboard at Settings → API. Make sure there are no extra spaces in your credentials.

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.

Track 1000 monthly clicks with all features included.

Get Started for Free

No credit card required