Articles on: AI in Metricool
This article is also available in:

How to connect Metricool’s MCP

Connect the Metricool MCP with Other Tools


This guide explains the available methods to connect the MCP (Metricool Connector Protocol) with different platforms and AI tools. The MCP is an intelligent tool that integrates with your Metricool account to optimize your social media management, allowing you to schedule content with the best posting times, offer personalized recommendations based on your data, analyze your metrics automatically, and help you save time while improving your results.


To use this new technology, you must have a Metricool account with an Advanced plan or higher, since authentication is required.


📌​ In this article





What You Need Before Getting Started


Before connecting the MCP, make sure you have the following:


  • Metricool Advanced plan or higher – Free and Starter plans do not include access to the MCP because it requires authentication.
  • Active account on the tool you want to connect (ChatGPT, Make, Zapier, etc.)
  • Production URL of the Metricool MCP: https://ai.metricool.com/mcp


We recommend reviewing the privacy policy of the app you are going to connect before authorizing access to the MCP.


Available Connection Methods


Connection Method

Description

Supported Tools

URL-Based Connection (HTTP/OAuth)

The most common and simplest method.

ChatGPT, Make, Zapier, Smithery, Mistral Chat, Cursor

Header Token Connection

Advanced method requiring authentication tokens in HTTP headers.

N8N

CLI Connection

For developers who prefer working from the terminal.

Claude Code, Gemini CLI


If you're a non-technical user, we recommend using URL-based connections since they’re the easiest and most visual.


What Permissions the MCP Grants


When you connect the MCP, the AI tool will be able to access the following data and features of your Metricool account:


  • View and manage your brands and social network connections
  • View and download metrics, analytics, and reports
  • View, create, and publish posts (both scheduled and already published)
  • View and manage your SmartLinks
  • View and manage inbox messages and comments on posts
  • View and manage Google My Business reviews
  • View and manage ad campaigns (Ads)
  • View and manage automatic lists (autolists)
  • View folders and files in your connected Canva and Google Drive accounts


These permissions grant full access to your Metricool account, similar to logging in directly. Only authorize the MCP in tools you trust. You can revoke access at any time from your account settings.



How to connect Metricool’s MCP step by step


To help you connect the Metricool MCP using the method that best fits your workflow, the following sections walk you through each step for all supported clients — including ChatGPT, Make, Zapier, Smithery, Mistral Chat, Cursor, N8N, Claude Code, and Gemini CLI — whether you're using URL-based connections, header token authentication, or command-line tools.


ChatGPT


  1. Go to the ChatGPT page → ChatGPT . To be able to add connectors in ChatGPT, it is necessary to have a developer account.
  2. To connect in ChatGPT, you need to click on the profile and settings icon.



  1. Once in Settings, go to Apps & Connectors > Advanced Settings and enable Developer Mode:



  1. With Developer Mode enabled, in Apps & Connectors, click on the 'Create' button (top right) and add the MCP configuration.




  1. The next step is to grant the MCP access to use your Metricool account.




  1. Metricool’s MCP will now be available in the chat with its corresponding tools.





Make


  1. Go to a new scenario in Make.com
  2. Add new module and search MCP


 


  1. Crete a connection


 


  1. Add new MCP Server and add the Metricool URL. Click Save



  1. Automatically, a new window will open to log in to Metricool and authorize the access



  1. Now, you can use the Metricool MCP in both ways: selecting a tool and using it, or adding the task as a prompt, and the MCP will do the actions.

 

Zapier


  1. Go to Zapier.com and start a new Zap
  2. Add new Action and search “MCP” and use “MCP Client”


 


  1. Go to Sign In. Add the Metricool MCP URL and continue


 


  1. Login into Metricool and authorize the access

 


  1. Now, you can use the Metricool MCP inside Zapier.


Smithery


  1. Go to the Smithery page (free plan) → https://smithery.ai/playground
  2. At the bottom, in the text box, click on 'Add tool'.



  1. Enter the URL in the search bar and click on 'Connect to MCP server.



  1. The next step is to grant the MCP access to use your Metricool account.



  1. Once the connection has been established, you will be able to see the available tools and it will be ready for interaction.

 

Mistral chat


  1. Go to the Mistral chat page (free plan) → Le Chat
  2. In the left panel, go to Intelligence and Connectors.



  1. You will see featured connectors. To add the Metricool connector, you must click on the 'Add connector' button.



  1. In 'Personalized MCP connector' you will need to add the following: connector name, connector server (URL), description (optional), and the authentication method, which is OAuth2.1, then click on 'Connect'.



  1. The next step is to grant the MCP access to use your Metricool account.



  1. At the bottom, you will have your available connectors, ready to use in a chat or to view the available tools.

 



Cursor


To be able to add MCPs to Cursor you need the Cursor Desktop app, you can download it here: Download.


After logging into your Cursor account, you have two options:

](#3-metricool-mcp-install-without-cursor-link)


  1. Copy any of this links in your browser:

Deep link: cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3D

Web link: Auth | Cursor - The AI Code Editor

  1. These links will open your Cursor Desktop App and ask if you want to add the MCP server:


 

  1. After clicking Install, the MCP server will appear in your Installed MCP tab. However, it shows that it needs authentication, so click Connect:


 

  1. It will ask you to open an external URL in your browser to authorize the connection with Metricool:

 


  1. After granting access, the Cursor application will open again, and the MCP will be connected.


  1. The first step is to click on the settings gear at the top right and go to the Tools & MCP section:



 

  1. Once inside the section, click on Add Custom MCP to open the mcp.json file:



 

  1. Originally, if no MCP is connected, the mcp.json file has the following structure:```
{
"mcpServers": {}
}


To add an MCP server, in this case Metricool’s, you need to insert the following code snippet inside mcpServers:


"metricool-mcp": {
"url": "https://ai.metricool.com/mcp",
"type": "http"
}


The final result should be as follows:



{
"mcpServers": {
"metricool-mcp": {
"url": "https://ai.metricool.com/mcp",
"type": "http"
}
}
}


Remember to save the file by clicking Files > Save.


  1. Back in the Tools & MCP section, the MCP should appear as unauthenticated, so follow the same process by clicking Connect:


 

  1. It will ask you to open an external URL in your browser to authorize the connection with Metricool:


 

  1. After granting access, the Cursor application will open again, and the MCP will be connected.



 


N8N


  1. Go to N8N and create new workflow


  1. Add new AI Agent node


 

  1. Inside the tools of the AI Agent search MCP Client Tool


 

  1. Add the Metricool URL to the endpoint field
  2. Select in Authentication → Header Auth

 


  1. Create new credential.
  2. Add the Name → X-Mc-Auth
  3. And the value → Your Metricool API Key (You can find in your account settings)

 


  1. Save the Credential and you will have something like this


 

  1. Now you can use the Metricool MCP inside N8N

 


Although its use is more focused on specific tasks and a more specialized audience, there are also command-line clients capable of using Metricool’s MCP.


Claude Code


  1. To use Claude Code, you need a Pro or Max subscription and must install it from this website Claude Code | Claude .
  2. After installing it, you need to type the following command in the terminal where you will use it:

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

  1. Start Claude Code by entering the command claude:



  1. Enter the /mcp command in Claude Code to see your active MCPs and select the Metricool one. When you press Enter, it will show that authentication is required to connect. Press 1 or Enter to Authenticate:



  1. A browser tab will open requesting authorization:



  1. When you click on Grant access, a message will appear indicating that everything was successful and that you can return to Claude Code:



  1. The MCP will be connected:


 

Gemini CLI


  1. To download Gemini CLI you need to open a terminal and run the following command:
npm install -g @google/gemini-cli 
  1. Once installed, you need to access the configuration file, located in one of the following paths:
  • /etc/gemini-cli/system-defaults.json (Linux)
  • C:\ProgramData\gemini-cli\system-defaults.json (Windows)
  • /Library/Application Support/GeminiCli/system-defaults.json (macOS).

The path can be overridden using the GEMINI_CLI_SYSTEM_DEFAULTS_PATH environment variable.


  1. In the configuration file, add this code snippet:
{
"mcpServers": {
"metricool": {
"httpUrl": "https://ai.metricool.com/mcp"
}
},
"security": {
"auth": {
"selectedType": "oauth-personal"
}
}
  1. Save the file and open a Gemini CLI terminal with the gemini command. Run the following command:
/mcp auth metricool
  1. A browser tab will open requesting authorization:



  1. After granting access, you can return to your terminal and the MCP will be connected.

 


Updated on: 25/11/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!