Install and Set Up the Metricool MCP in Claude Desktop

Install and Set Up the Metricool MCP in Claude Desktop

Follow these steps to integrate Metricool into the Claude Desktop app.

⚠️ Keep in mind that steps may vary slightly depending on your version of Claude Desktop.

Step 1: Download Claude Desktop and Access the Metricool Repository

1. Download Claude Desktop: Go to claude.ai/download and download the version for your operating system.
2. Access the Metricool MCP repository: Visit https://github.com/metricool/mcp-metricool
3. Click the UV link: Scroll down the page until you see the UV section and click on it.
4. Copy the install command: In the new tab that opens, you'll see a section called Installing uv. Copy the first line of the command based on your OS.

Step 2: Install the Metricool MCP

1. Open your terminal

• On macOS: open Terminal from Launchpad.
• On Windows: open CMD or Command Prompt.

2. Paste and run the command: Paste the copied command into your terminal and hit Enter.
3. Close the terminal: Once you see the install completed message, you can close the window.

Step 3: Configure Claude Desktop

To ensure you're using the latest version, add this code to your claude_desktop_config.json file:

{
    "mcpServers": {
        "mcp-metricool": {
            "command": "uvx",
            "args": [
                "--upgrade",
                "mcp-metricool"
            ],
            "env": {
                "METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>",
                "METRICOOL_USER_ID": "<METRICOOL_USER_ID>"
            }
        }
    }
}

1. Copy the Configuration Code.
2. Open Claude Desktop Settings:

• Launch your Claude Desktop app.
• Go to Settings.
• Select Developer.
• Click on Edit configuration. This will open up Claude Desktop's config file.

3. Paste the Config Code: Paste the code you copied into that open config file.
4. Update Your Metri Credentials: Inside the code you just pasted, you'll need to find and replace the placeholders with your Metricool User Token and User ID. Make sure those are the right credentials!
5. Save Your Changes: Save the configuration file.

Step 4: Restart Claude Desktop and Fix Errors (If Needed)

1. Restart Claude Desktop: Fully close and reopen the app.
2. Connection error handling: If you see an error like "could not connect to MCP server", follow these steps:

• Go back to Settings > Developer > Edit configuration
• Open the cloud/desktop/config.json file
• Run the UV command again for your OS
• Copy the new (green) line generated
• Replace the old config line with this new one
• Make sure the line ends with a slash / if needed
• Save the file and restart Claude again

Step 5: Verify the Installation

Once the app restarts, you should see the MCP working properly.

Now you can start using it—search brands, schedule content, or analyze data directly from Claude Desktop with the Metricool integration.

Updated on: 01/08/2025