meta — Claude Code MCP server: features and setup
Connect an AI agent to Instagram and Threads publishing, analytics, and Meta account tools. Use it to handle social tasks from your coding assistant.
claude mcp add --env INSTAGRAM_ACCESS_TOKEN=<INSTAGRAM_ACCESS_TOKEN> --env INSTAGRAM_USER_ID=<INSTAGRAM_USER_ID> --env INSTAGRAM_MESSAGING_ACCESS_TOKEN=<INSTAGRAM_MESSAGING_ACCESS_TOKEN> --env INSTAGRAM_PAGE_ID=<INSTAGRAM_PAGE_ID> --env THREADS_ACCESS_TOKEN=<THREADS_ACCESS_TOKEN> --transport stdio meta -- npx -y @mikusnuz/meta-mcpWhat meta does
This server connects an agent to the Instagram Graph API, Threads API, and Meta management tools. It can publish photos, videos, and carousels, handle comments and Instagram messages, and retrieve account or post analytics. Threads tools also cover polls, GIF attachments, and public post search.
The package includes 66 tools, profile resources for Instagram and Threads, and prompts for cross-platform publishing and analytics reports. It also handles token exchange and refresh, webhook management, and rate-limit tracking through the x-app-usage header.
Node.js 20 or later and access tokens are required. Instagram Graph API use requires a business or creator profile; a personal profile cannot use that API. Meta token and webhook tools require a Meta Developer App.
What it helps with
- publish an Instagram photo or carousel
- reply to Instagram comments and messages
- retrieve Threads account analytics
- search public posts by keyword
- refresh a Meta token or manage a webhook
Example prompts for the agent
- Publish this photo to Instagram and add an accessibility description.
- Find public Threads posts about the keyword “design”.
- Show my Threads account metrics and draft a short report.
How to install meta
Platform CLI
claude mcp add --env INSTAGRAM_ACCESS_TOKEN=<INSTAGRAM_ACCESS_TOKEN> --env INSTAGRAM_USER_ID=<INSTAGRAM_USER_ID> --env INSTAGRAM_MESSAGING_ACCESS_TOKEN=<INSTAGRAM_MESSAGING_ACCESS_TOKEN> --env INSTAGRAM_PAGE_ID=<INSTAGRAM_PAGE_ID> --env THREADS_ACCESS_TOKEN=<THREADS_ACCESS_TOKEN> --transport stdio meta -- npx -y @mikusnuz/meta-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add meta --env INSTAGRAM_ACCESS_TOKEN=<INSTAGRAM_ACCESS_TOKEN> --env INSTAGRAM_USER_ID=<INSTAGRAM_USER_ID> --env INSTAGRAM_MESSAGING_ACCESS_TOKEN=<INSTAGRAM_MESSAGING_ACCESS_TOKEN> --env INSTAGRAM_PAGE_ID=<INSTAGRAM_PAGE_ID> --env THREADS_ACCESS_TOKEN=<THREADS_ACCESS_TOKEN> -- npx -y @mikusnuz/meta-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"meta": {
"command": "npx",
"args": [
"-y",
"@mikusnuz/meta-mcp"
],
"env": {
"INSTAGRAM_ACCESS_TOKEN": "<INSTAGRAM_ACCESS_TOKEN>",
"INSTAGRAM_USER_ID": "<INSTAGRAM_USER_ID>",
"INSTAGRAM_MESSAGING_ACCESS_TOKEN": "<INSTAGRAM_MESSAGING_ACCESS_TOKEN>",
"INSTAGRAM_PAGE_ID": "<INSTAGRAM_PAGE_ID>",
"THREADS_ACCESS_TOKEN": "<THREADS_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"meta": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mikusnuz/meta-mcp"
],
"env": {
"INSTAGRAM_ACCESS_TOKEN": "<INSTAGRAM_ACCESS_TOKEN>",
"INSTAGRAM_USER_ID": "<INSTAGRAM_USER_ID>",
"INSTAGRAM_MESSAGING_ACCESS_TOKEN": "<INSTAGRAM_MESSAGING_ACCESS_TOKEN>",
"INSTAGRAM_PAGE_ID": "<INSTAGRAM_PAGE_ID>",
"THREADS_ACCESS_TOKEN": "<THREADS_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
gemini mcp add -e INSTAGRAM_ACCESS_TOKEN=<INSTAGRAM_ACCESS_TOKEN> -e INSTAGRAM_USER_ID=<INSTAGRAM_USER_ID> -e INSTAGRAM_MESSAGING_ACCESS_TOKEN=<INSTAGRAM_MESSAGING_ACCESS_TOKEN> -e INSTAGRAM_PAGE_ID=<INSTAGRAM_PAGE_ID> -e THREADS_ACCESS_TOKEN=<THREADS_ACCESS_TOKEN> meta npx -y @mikusnuz/meta-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about meta
How do I install meta in Claude Code?
Run `claude mcp add meta -e INSTAGRAM_ACCESS_TOKEN=<INSTAGRAM_ACCESS_TOKEN> -e INSTAGRAM_MESSAGING_ACCESS_TOKEN=<INSTAGRAM_MESSAGING_ACCESS_TOKEN> -e THREADS_ACCESS_TOKEN=<THREADS_ACCESS_TOKEN> -e META_APP_SECRET=<META_APP_SECRET> -- npx -y @mikusnuz/meta-mcp`. Replace the placeholders with your credentials.
What does the meta MCP server do?
It gives an agent access to Instagram Graph API, Threads API, and Meta management tools. The agent can publish content, handle comments and messages, fetch analytics, and manage tokens.
What Instagram account can use meta?
Instagram Graph API access requires a business or creator profile. Personal profiles cannot use this API.
