meta-mcp
Provides tools for managing an Instagram professional account via the official Meta API: retrieving account insights and metrics, analyzing other professional profiles, publishing photos, carousels, reels, and stories, and managing comments and Direct messages.
Integrates with Meta's Graph API for authentication, long-lived token management, and generic Graph API requests through the graph_request tool.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meta-mcpshow me my Instagram insights for the last 7 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
meta-mcp
Conecte o Claude ao seu Instagram pela API oficial da Meta.
Depois de instalado, você conversa com o Claude e ele mexe no seu perfil por você: puxa os números, analisa outros perfis, publica e cuida dos comentários. Sem app de terceiro pedindo a sua senha.
O que dá pra fazer
Seus números, na hora: alcance, visualizações, interações, seguidores ganhos, desempenho de cada post.
Estudar o mercado: analisar qualquer perfil profissional (concorrente, referência, marca) com os últimos posts e o engajamento de cada um.
Publicar: foto, carrossel, reel e story, com legenda.
Comentários: ler, responder, esconder e apagar.
Direct: ler conversas, responder e mandar mensagem para quem comentou (veja a ressalva abaixo).
E o resto da API: a ferramenta
graph_requestchama qualquer endpoint da Graph API.
Related MCP server: Instagram MCP Server
Antes de começar
Instagram profissional (Criador ou Empresa) ligado a uma Página do Facebook.
Node.js 20 ou mais novo.
Claude Desktop (ou Claude Code).
Um app no painel de desenvolvedores da Meta, com o caso de uso do Instagram na opção "API com Login do Facebook".
Instalação em 3 passos
1. Gere um token no Explorador da Graph API: escolha o seu app, clique em Gerar token de acesso e marque estas permissões:
instagram_basic
instagram_manage_insights
instagram_content_publish
instagram_manage_comments
instagram_manage_messages
pages_show_list
pages_read_engagement
business_management2. Rode o setup no terminal:
npx -y github:alissonjcdev/meta-mcp setupEle pede o App ID, a chave secreta do app e o token. Depois troca o token por um que vale 60 dias, acha a sua conta do Instagram e já configura o Claude Desktop (guardando uma cópia do arquivo que existia antes).
3. Feche e abra o Claude Desktop. Peça: "Como foi meu Instagram nos últimos 7 dias?"
Para usar no Claude Code, o setup também mostra o comando claude mcp add pronto para copiar.
Comandos
comando | o que faz |
| conecta a conta e configura o Claude Desktop |
| mostra se o token está válido e até quando |
| troca por um token novo quando o atual vencer (a cada ~60 dias) |
Use npx -y github:alissonjcdev/meta-mcp <comando> se não tiver instalado.
Onde ficam os seus dados
Tudo fica só no seu computador, em ~/.meta-mcp/config.json (no Windows, %USERPROFILE%\.meta-mcp\config.json), com acesso restrito ao seu usuário. Nada passa por servidor nosso. Para servidores, você pode usar variáveis de ambiente no lugar do arquivo: META_ACCESS_TOKEN, META_APP_ID, META_APP_SECRET, META_IG_USER_ID e META_PAGE_ID.
Ressalva honesta sobre o Direct
Enquanto o seu app está em modo de desenvolvimento (o padrão), a Meta só deixa ler e mandar Direct para contas que têm função no app (você e quem você adicionar como testador). Para responder qualquer pessoa, inclusive com o "comentário vira DM", o app precisa passar pela Análise do App da Meta e ganhar Acesso Avançado a instagram_manage_messages. O resto (números, análise de perfis, publicação, comentários) funciona na sua própria conta sem análise.
Publicar, responder e mandar mensagem são ações reais. O Claude deve sempre te mostrar o que vai fazer e esperar a sua confirmação.
Licença
MIT. Feito por Alisson Chaves com o MCP SDK oficial da Anthropic.
This server cannot be deployed
Maintenance
Related MCP Connectors
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Create, schedule and publish Instagram and Facebook posts from Claude or ChatGPT.
Publish to Instagram from chat — official Graph API, OAuth 2.1, free for your own posts.
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables sending and receiving Instagram Direct Messages, managing conversations, downloading media, viewing user profiles and stories, and interacting with posts through natural language in Claude.MIT
- AlicenseAqualityBmaintenanceConnects Claude Desktop and other MCP clients to the Instagram Graph API for reading analytics, managing comments, and publishing photos, carousels, and reels.1145 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to read and send Instagram DMs, manage threads and message requests, send media, and run autonomous conversations via the /dm skill.3MIT
- AlicenseNot gradedqualityCmaintenanceExposes Instagram actions (posts, media, comments, DMs, insights, Messenger profile) to Claude and ChatGPT via MCP.MIT