mcp-instagram-dm

⚡ Primeros pasos

Ponte en marcha en menos de 60 segundos:

1. Añádelo a tu configuración de MCP (Claude Desktop, Claude Code o 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. Habla con tu asistente de IA:

"Lee mis DMs de Instagram"

Eso es todo: estás listo. 🎉

¿Necesitas ayuda para obtener tus cookies? Consulta Configuración más abajo.

🎬 Cómo se ve

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!"

✨ Características

15 herramientas en tres categorías: todo lo que necesitas para gestionar tus DMs de Instagram:

📥 Leer y supervisar

✏️ Enviar y gestionar

🔍 Buscar y descubrir

📦 Instalación

npx (recomendado: instalación cero)

npx mcp-instagram-dm

npm global

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

Desde el código fuente

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

🔧 Configuración

Obtener tus cookies

1. Abre instagram.com en Chrome e inicia sesión
2. Pulsa F12 → pestaña Application → Cookies → https://www.instagram.com
3. Copia estos tres valores:

💡 Consejo: También puedes ejecutar node get-cookies.js para una guía paso a paso.

Variables de entorno

Configuración del 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"
      }
    }
  }
}

💬 Ejemplos de uso

Simplemente habla de forma natural con tu asistente de IA:

📖 Referencia de herramientas

🏗️ Arquitectura

┌─────────────────────┐     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) │
                                             └──────────────────────┘

Principios de diseño:

• Dependencia única: solo @modelcontextprotocol/sdk. Sin axios, sin puppeteer, sin inflado.
• TypeScript estricto: cero tipos any, interfaces totalmente tipadas en src/types.ts
• Auto-paginación: solicita 500 mensajes y el servidor se encarga del resto con limitación de velocidad
• Más de 14 tipos de mensajes: texto, multimedia, voz, reels, enlaces, clips, GIFs, publicaciones, historias y más

🔒 Seguridad

• Las cookies de sesión nunca se registran ni se almacenan más allá del tiempo de ejecución
• Todas las credenciales se leen únicamente de variables de entorno
• No se envían datos a ningún servicio de terceros
• Consulta SECURITY.md para informar vulnerabilidades

⚠️ Aviso legal

Este proyecto utiliza la API web no oficial de Instagram, que puede cambiar sin previo aviso.

• Solo para uso personal: no lo uses para spam, mensajes masivos o automatización que viole los Términos de servicio de Instagram
• Tus cookies de sesión son credenciales sensibles: nunca las compartas ni las subas a un repositorio
• Este proyecto no está afiliado, respaldado ni conectado con Meta o Instagram
• Úsalo bajo tu propio riesgo: los autores no son responsables de ninguna restricción de cuenta

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para la configuración de desarrollo y las pautas.

Si deseas apoyar el proyecto económicamente, considera patrocinar en GitHub.

📄 Licencia

MIT — Hecho con ❤️ por Kynux