Using Metricool within Claude Code

Metricool’s official MCP connects your account to Claude (Code, Desktop, or whichever client you use) and lets the conversation do the work: scheduling posts, reading analytics, checking your best posting times, reviewing competitors — all in plain language, without ever opening the dashboard.

3.5+ million professionals already trust Metricool

What Is Metricool’s MCP?

Metricool’s MCP is the official server that connects your Metricool account with Claude Code, Claude Desktop, Cursor, ChatGPT, Mistral Le Chat, Make, and n8n. Once connected, you simply ask the mode for whatever you need regarding your social networks, and it communicates with Metricool on your behalf.

Questions that would normally have you opening five tabs.

These aren’t demos. They’re the questions you already ask yourself every Monday morning when you sit down to plan your week. Each one becomes a single message in Claude.

Claude reads your Instagram metrics, sorts by engagement, and gives you a top 3 with an explanation of why.

Pull data from the competitors you’ve already set up in Metricool and put it side by side with your own data.

Get a rundown of your active campaigns across Meta, Google, and TikTok Ads without leaving the chat. Perfect for quick client check-ins.

One instruction, three platforms. Optimal posting time per channel based on your data. Zero copy-pasting between dashboards.

Claude reads real patterns from your account — not generic tips from the internet — and suggests ideas rooted in what’s already working for you.

No need to open the planner. Just tell Claude what to change, and it updates the scheduled post for you.”

How to connect

Five minutes. No technical setup required.

Open your AI tool, paste in the Metricool URL, and connect your account.

Four steps, no coding knowledge needed:

Open whichever AI tool you normally use (Claude Code, Claude Desktop, Claude.ai…)

Add a new MCP connection by pasting the Metricool URL: https://ai.metricool.com/mcp”

Log in to your Metricool account to link your brands, analytics, and content to the AI.

Approve access

Ten networks, one conversation.

Everything you already manage in Metricool — now accessible through simple conversation.

Over 20 tools, each one explained.

You don’t need to memorize any of the tools below. Claude figures out which tool to use based on what you ask. We’re sharing them for transparency — and because it can be handy to know what’s happening behind the scenes.

get_brands
Lists the brands set up in your account.
get_analytics
Metrics from any connected social network.
get_metrics
Available metrics for a specific network.
get_best_time_to_post
Best performing days and times for each network, based on your data.
post_schedule_post
Schedule posts across multiple brands and networks.
update_schedule_post
Update the text, date, or network of a scheduled post.
get_scheduled_posts
List your queued posts.
get_instagram_posts
Instagram posts with metrics for a given date range.
get_instagram_reels
Published Reels with their performance data.
get_instagram_stories
Stories within a date range.
get_tiktok_videos
TikTok videos with their associated metrics.
get_facebook_posts
Facebook posts by brand and date range.
get_facebook_reels
Facebook Reels by brand and date range.
get_facebook_stories
Facebook Stories by brand and date range.
get_linkedin_posts
LinkedIn posts with their metrics.
get_x_posts
X (Twitter) posts with their metrics.
get_youtube_videos
Published videos with performance data
get_pinterest_pins
Pinterest pins with metrics.
get_pinterest_boards
Available boards for scheduling.
get_thread_posts
Threads posts with their metrics
get_bluesky_posts
Bluesky posts with their metrics.
get_twitch_videos
Twitch Videos.
get_facebookads_campaigns
Active Meta Ads campaigns.
get_googleads_campaigns
Active Google Ads campaigns.
get_tiktokads_campaigns
Active TikTok Ads campaigns.
get_network_competitors
Competitors you’ve added to your account.
get_network_competitors_posts
Competitor posts and their metrics.

This list is updated alongside the MCP server. The most up-to-date version is always in Metricool’s public GitHub repository.

What people ask us

If your question isn’t here, reach out and we’ll add it.

FAQs

What exactly is Metricool’s MCP?

It’s Metricool’s official MCP server. It acts as a bridge between your Metricool account and any client that supports the Model Context Protocol (Claude Code, Claude Desktop, Cursor, ChatGPT with Developer Mode, Mistral Le Chat, Make, n8n). Once connected, those clients can read and act on your Metricool data on your behalf.

Do I need to know how to code?

No. The connection is made via URL or a command you copy and paste once. After that, you just talk to Claude in plain language: “check my Reels from the last month” or “schedule this post for tomorrow at 10am.

Which social networks does it support?

Instagram (posts, reels, stories), TikTok, LinkedIn, Facebook (posts, reels, stories), X (Twitter), YouTube, Pinterest (pins and boards), Threads, Bluesky, and Twitch. Plus campaign data from Meta Ads, Google Ads, and TikTok Ads.

Does it work on Claude Desktop as well as Claude Code?

Yes. The MCP works with Claude Code, Claude Desktop, Cursor, ChatGPT (Developer Mode), Mistral Le Chat, Make, n8n, Smithery, and Gemini CLI. The way you add it varies slightly depending on the client, but it’s the same server throughout.

Which Metricool plan do I need?

The MCP works with any Metricool plan, including the free account. The limitations that apply are those of your current plan. For example, with the free account you can’t access data older than 3 months or schedule more than 20 posts. Paid plans expand those limits.

How do I authenticate?

There are two options: via OAuth, by authorizing through a browser tab, or with your METRICOOL_USER_TOKEN and METRICOOL_USER_ID, which you can find in your Metricool account settings.

Do posts publish instantly or get scheduled?

It’s entirely your call. You can ask for it to go out right away, schedule it for a specific date and time, or use the optimal time based on your account data.

Can I manage multiple brands?

Yes. If your Metricool account has multiple brands, Claude lists them (using get_brands) and works with whichever one you specify in each conversation.

Can I edit already-scheduled posts?

Yes. Using update_schedule_post you can change the text, date, or platform of a scheduled post within the same conversation.

Is my data secure?

The MCP uses the same permissions and authentication as your Metricool account. You can revoke access at any time from your settings. Your data is not stored in the model.

What’s the difference between this and MetriLAB AI?

MetriLAB AI is the native Claude integration built directly into Metricool. The MCP is the technical layer that powers it — and one you can also use outside of Metricool, in any client that supports the Model Context Protocol.

Is it open source?

Metricool’s MCP server is publicly available in the metricool/mcp-metricool repository on GitHub. It’s also published as a package on PyPI.

Try it with your Metricool account

The MCP works with any Metricool plan, including the free one. If you already have an account and a Claude client, you’re five minutes away. If not, create a free account and try it out before committing.

https://ai.metricool.com/mcp