mcp-instagram-dm

⚡ Começando

Comece a usar em menos de 60 segundos:

1. Adicione à sua configuração MCP (Claude Desktop, Claude Code ou Cursor):

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

2. Converse com seu assistente de IA:

"Leia minhas DMs do Instagram"

É isso — você está pronto. 🎉

Precisa de ajuda para obter seus cookies? Veja Configuração abaixo.

🎬 Como Fica

You:    "Show me my unread Instagram DMs"
Claude: Fetching your inbox...

        📬 Inbox (3 conversations)

        [UNREAD] john_doe (thread_id: 340282366841710300...)
          Last: [2026-03-29 14:23:01] john_doe: Hey, are you free tonight?

        [UNREAD] [GROUP] project_team (thread_id: 340282366841710301...)
          Last: [2026-03-29 13:45:22] alice: Meeting moved to 3pm

        jane_smith (thread_id: 340282366841710302...)
          Last: [2026-03-29 10:12:45] You: Thanks! See you then

You:    "Reply to john_doe: Yeah, let's meet at 7!"
Claude: ✅ Message sent: "Yeah, let's meet at 7!"

✨ Recursos

15 ferramentas em três categorias — tudo o que você precisa para gerenciar suas DMs do Instagram:

📥 Ler e Monitorar

✏️ Enviar e Gerenciar

🔍 Buscar e Descobrir

📦 Instalação

npx (recomendado — instalação zero)

npx mcp-instagram-dm

npm global

npm install -g mcp-instagram-dm
mcp-instagram-dm

A partir do código-fonte

git clone https://github.com/KynuxDev/mcp-instagram-dm.git
cd mcp-instagram-dm
npm install && npm run build
node dist/index.js

🔧 Configuração

Obtendo Seus Cookies

1. Abra instagram.com no Chrome e faça login
2. Pressione F12 → aba Application → Cookies → https://www.instagram.com
3. Copie estes três valores:

💡 Dica: Você também pode executar node get-cookies.js para um passo a passo guiado.

Variáveis de Ambiente

Configuração do Cliente

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "mcp-instagram-dm"],
      "env": {
        "INSTAGRAM_SESSION_ID": "your_session_id",
        "INSTAGRAM_CSRF_TOKEN": "your_csrf_token",
        "INSTAGRAM_DS_USER_ID": "your_user_id"
      }
    }
  }
}

💬 Exemplos de Uso

Basta conversar naturalmente com seu assistente de IA:

📖 Referência de Ferramentas

🏗️ Arquitetura

┌─────────────────────┐     MCP (stdio)     ┌──────────────────────┐
│   AI Assistant       │◄──────────────────►│   MCP Server          │
│   (Claude, Cursor)   │                     │   src/index.ts        │
└─────────────────────┘                     │   15 tools            │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Client    │
                                             │   src/instagram.ts    │
                                             │   Cookie auth + HTTP  │
                                             └──────────┬───────────┘
                                                        │
                                             ┌──────────▼───────────┐
                                             │   Instagram Web API   │
                                             │   (Private endpoints) │
                                             └──────────────────────┘

Princípios de design:

• Dependência única — apenas @modelcontextprotocol/sdk. Sem axios, sem puppeteer, sem inchaço.
• TypeScript estrito — zero tipos any, interfaces totalmente tipadas em src/types.ts
• Paginação automática — solicite 500 mensagens e o servidor cuida do resto com limitação de taxa
• 14+ tipos de mensagem — texto, mídia, voz, reels, links, clipes, GIFs, publicações, stories e mais

🔒 Segurança

• Cookies de sessão nunca são registrados ou armazenados além do tempo de execução
• Todas as credenciais são lidas apenas de variáveis de ambiente
• Nenhum dado é enviado a serviços de terceiros
• Veja SECURITY.md para reportar vulnerabilidades

⚠️ Aviso Legal

Este projeto usa a API web não oficial do Instagram, que pode mudar sem aviso prévio.

• Uso pessoal apenas — não use para spam, mensagens em massa ou automação que viole os Termos de Serviço do Instagram
• Seus cookies de sessão são credenciais sensíveis — nunca os compartilhe ou faça commit deles
• Este projeto não é afiliado, endossado ou conectado à Meta ou ao Instagram
• Use por sua conta e risco — os autores não são responsáveis por quaisquer restrições de conta

🤝 Contribuindo

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para configuração de desenvolvimento e diretrizes.

Se você quiser apoiar o projeto financeiramente, considere patrocinar no GitHub.

📄 Licença

MIT — Feito com ❤️ por Kynux