Metricool MCP

How to connect Metricool's MCP with Claude

Updated 2 weeks ago

Interface screenshots are shown in English.

Metricool's MCP works with Claude Desktop, Claude.ai, and Claude Code so you can manage brands, analytics, and posts from Claude with natural language. Metricool is listed in Claude's Connectors Directory: connect it once from Claude Desktop or Claude.ai and the connection applies to your account across both, plus Claude for iOS and Android. Claude Code connects separately 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 and Claude.ai

Yes

Available on Claude Free, Pro, Max, Team, and Enterprise. Free can use only one connector at a time. One connection covers both surfaces.

Settings → Connectors → Browse connectors → search Metricool, or open the Metricool listing directly

Claude Code

Yes

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

CLI: claude mcp add --transport http

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, Claude.ai, or Claude Code — Claude Code needs Pro or Max and installation from Claude Code

  • Production MCP URL: https://ai.metricool.com/mcp — only needed for Claude Code or the manual fallback for Claude Desktop

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

What permissions the MCP grants

When you authorize the connection, Claude can access these parts of your Metricool account within your plan limits:

  • See and manage all your brands and their network connections

  • See and download all your metrics and reports

  • See, create, and publish posts in any connected network

  • See and manage all your Smartlinks

  • See and manage all inbox messages and post comments

  • See and manage all GMB reviews

  • See and manage the Ads campaigns of the accounts connected to any of your brands

  • See and manage your autolists

  • See folders and files of any Canva or Drive accounts connected to Metricool

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

Connect Claude Desktop and Claude.ai

Metricool is listed in Claude's Connectors Directory, so you can connect it in a few clicks without editing any configuration file. Connect from either surface — the connection is tied to your Claude account, not the app.

  1. Open Settings, go to Connectors, and click Add → Browse connectors to open the directory — or skip straight to the Metricool listing.

  2. If you opened the directory, search for Metricool.

Can't find Metricool in Connectors? Connect it manually with mcp-remote

If the directory listing isn't available yet for your region or Claude plan, connect Claude Desktop manually with mcp-remote instead.

  1. Open Settings from your profile, then open Developer and 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.

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

  1. Click the + next to the result, or open the Metricool listing and click Connect to Claude. Both open the same authorization screen.

  2. Review the requested permissions and click Grant access.

  3. Confirm Metricool shows as Connected.

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

Disconnect Metricool

Open Settings → Connectors, click the three-dot menu next to Metricool, and choose Disconnect.

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 Free already using another connector, and Claude Code missing Pro/Max. Work through those fixes in I can't connect to Metricool MCP.

Additional resources

  • 📹 Claude for Social Media: Automate Your Reports with This Skill — EN · ES · DE

  • 📹 6 Social Media Tasks You Can Automate with Claude Cowork — EN · ES · FR

Related articles

Was this helpful?
Was this helpful?