Metricool MCP

How to connect Metricool's MCP with Claude

Updated 2 weeks ago

The screenshots in this guide are in English.

Metricool’s MCP works with Claude Desktop and Claude Code so you can manage brands, analytics, and posts from Claude with natural language. Claude Desktop connects through the mcp-remote workaround; Claude Code connects over HTTP from the CLI.

For other clients, see How to connect Metricool’s MCP. For plan limits that still apply after you connect, see MCP limits and plan requirements.

Claude compatibility

Use this matrix to confirm which Claude surface you can connect and what each one requires.

Claude surface

Supported in Metricool docs

Requirements

Connection method

Claude Desktop

Yes

Claude Desktop app; usual connector path is blocked by an external bug

mcp-remote via Settings → Developer → Edit config

Claude Code

Yes

Claude Pro or Max, plus Claude Code installed from the product page

CLI: claude mcp add --transport http

Claude.ai / custom connectors

Compatible as an MCP-capable client

Remote MCP custom connectors are available on Claude Free, Pro, Max, Team, and Enterprise. Free can use only one custom connector at a time.

Follow Anthropic’s custom connector flow with URL https://ai.metricool.com/mcp

Metricool MCP works with any Metricool plan, including Free. Your Metricool plan limits still apply. Claude Free’s one-connector limit and Claude Code’s Pro/Max requirement come from Anthropic, not from Metricool billing.

Before you start

Have these ready:

  • A Metricool account on any plan, including Free

  • Claude Desktop or Claude Code — Claude Code needs Pro or Max and installation from Claude Code

  • Production MCP URL: https://ai.metricool.com/mcp

Review Claude’s privacy policy before authorizing access to your Metricool account.

What permissions the MCP grants

When you connect MCP, Claude can access these parts of your Metricool account within your plan limits:

  • View and manage brands and social network connections

  • View and download metrics and analytics

  • View, create, and publish posts (scheduled and already published)

These permissions grant full access similar to signing in directly. Only authorize tools you trust. Revoke access from Claude when you want to disconnect Metricool.

Connect Claude Desktop

Claude Desktop cannot use the usual MCP connection path because of an external bug. Connect with mcp-remote instead.

  1. Open Settings from your profile.

Claude Desktop profile menu with Settings

  1. Open Developer, then click Edit config under Local MCP servers to open the Claude Desktop config file.

Claude Desktop Developer Edit config for Local MCP servers

  1. Add this configuration:

    {
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp"
      ]
    }
  }
}

    To authenticate with an API key instead of browser OAuth, use this configuration:

    {
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp",
        "--header",
        "X-Mc-Auth: <METRICOOL_API_KEY>"
      ]
    }
  }
}

  2. Save the file and restart Claude Desktop.

  3. If you used the OAuth configuration, complete browser authorization when prompted. The API key configuration skips the browser step.

Metricool MCP authorization in browser

  1. Start a chat and confirm Metricool appears as connected under Connectors.

Claude Desktop Connectors showing Metricool connected

After Claude is connected, see Metricool’s guide on managing social media with Claude for prompts and workflows.

Connect Claude Code

Claude Code requires a Pro or Max subscription and installation from the Claude Code product page before you can add Metricool.

  1. Install Claude Code from Claude Code.

  2. In the terminal where you use Claude Code, run:

    claude mcp add --transport http metricool https://ai.metricool.com/mcp

  3. Start Claude Code with claude.

Claude Code terminal after starting claude

  1. Run /mcp, select Metricool, and choose Authenticate when prompted.

Claude Code /mcp list with Metricool needing authentication

  1. Authorize Metricool in the browser and click Grant access.

Browser success message after granting Metricool access

  1. Return to Claude Code. Metricool MCP is connected.

Claude Code showing Metricool MCP connected

If Claude will not connect

Common Claude failures include the Desktop usual-path bug, Free already using another custom connector, and Claude Code missing Pro/Max. Work through those fixes in I can't connect to Metricool MCP.

Related articles

Was this helpful?
Was this helpful?