Enables reading and sending Instagram Direct Messages, including listing conversations, retrieving message history, sending messages to threads or users by username, adding emoji reactions, and searching for users.
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., "@Instagram DMs MCP show me my recent Instagram DMs"
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.
A Model Context Protocol (MCP) server that lets AI assistants read and send Instagram DMs.
Click the "Deploy to Render" button above
Add your environment variables in Render dashboard:
IG_COOKIES - Your Instagram cookies as JSON (see below)
POKE_API_KEY - Your Poke API key (optional, for DM notifications)
Your MCP server will be at https://your-service.onrender.com/mcp
Related MCP server: meta-mcp
Go to instagram.com and log in
Open DevTools (F12) → Application tab → Cookies → https://www.instagram.com
Copy these values into your .env:
Cookie | Env Variable |
|
|
|
|
|
|
|
|
|
|
|
|
git clone https://github.com/braindead-dev/instagram-dms-mcp.git
cd instagram-dms-mcp
# Build the gateway (requires Go 1.22+)
cd gateway && ./build.sh && cd ..
# Configure
cp env.example .env
# Edit .env with your cookies
# Run
pip install -r requirements.txt
python src/server.pyTool | Description |
| See all your conversations |
| Read messages with someone |
| Send a message |
| React to their last message |
User: "Check my Instagram DMs"
→ get_inbox()
User: "What did @johndoe say?"
→ get_conversation("johndoe")
User: "Reply with 'sounds good!'"
→ send_message("johndoe", "sounds good!")
User: "React with a heart"
→ react("johndoe", "❤️")To get notified when you receive new DMs:
Get your API key from poke.com/settings/advanced
Add to .env:
POKE_API_KEY=your_key_hereNew DMs will be forwarded to Poke as: 📩 Instagram DM from @username: message
The MCP simulates natural behavior by default:
Setting | Default | Description |
|
| Show typing indicator before sending |
|
| Mark as read when opening conversation |
|
| Seconds to "type" before sending |
This server cannot be deployed
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Instagram comment-to-DM automation for AI agents: keyword funnels, private replies, broadcasts.
Manage Instagram and Facebook automations, conversations, templates, and analytics with AI.
Instagram data for AI agents: profiles, posts, reels, followers. Influencer + brand research.