Mcp Instagram Dm

⚡ Getting Started

Get up and running in under 60 seconds:

1. Add to your MCP config (Claude Desktop, Claude Code, or 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. Talk to your AI assistant:

"Read my Instagram DMs"

That's it — you're ready. 🎉

Need help getting your cookies? See Configuration below.

🎬 What It Looks Like

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

✨ Features

15 tools across three categories — everything you need to manage your Instagram DMs:

📥 Read & Monitor

✏️ Send & Manage

🔍 Search & Discover

📦 Installation

npx (recommended — zero install)

npx mcp-instagram-dm

npm global

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

From source

git clone https://github.com/KynuxDev/mcp-instagram-dm.gitcd mcp-instagram-dmnpm install && npm run buildnode dist/index.js

🔧 Configuration

Getting Your Cookies

1. Open instagram.com in Chrome and log in
2. Press F12 → Application tab → Cookies → https://www.instagram.com
3. Copy these three values:

💡 Tip: You can also run node get-cookies.js for a guided walkthrough.

Environment Variables

Client Setup

{  "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"      }    }  }}

💬 Usage Examples

Just talk naturally to your AI assistant:

📖 Tools Reference

🏗️ Architecture

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

Design principles:

• Single dependency — only @modelcontextprotocol/sdk. No axios, no puppeteer, no bloat.
• TypeScript strict — zero any types, fully typed interfaces in src/types.ts
• Auto-pagination — request 500 messages and the server handles the rest with rate limiting
• 14+ message types — text, media, voice, reels, links, clips, GIFs, posts, stories, and more

🔒 Security

• Session cookies are never logged or stored beyond runtime
• All credentials are read from environment variables only
• No data is sent to any third-party service
• See SECURITY.md for reporting vulnerabilities

⚠️ Disclaimer

This project uses Instagram's unofficial web API, which may change without notice.

• Personal use only — do not use for spam, mass messaging, or automation that violates Instagram's Terms of Service
• Your session cookies are sensitive credentials — never share or commit them
• This project is not affiliated with, endorsed by, or connected to Meta or Instagram
• Use at your own risk — the authors are not responsible for any account restrictions

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for development setup and guidelines.

If you'd like to support the project financially, consider sponsoring on GitHub.

📄 License

MIT — Made with ❤️ by Kynux