Read, send, search, and manage Instagram Direct Messages through AI assistants via MCP. 15 tools including inbox, send, search, react, and thread management. Cookie-based auth, single dependency, TypeScript strict, auto-pagination.
Overview
MCP Instagram DM
Control your Instagram DMs with AI. Read, send, search, and manage Instagram Direct Messages through natural language with any MCP-compatible AI assistant.
Features
15 tools across three categories:
Read & Monitor
instagram_get_inbox— List DM conversations with unread/group/muted indicatorsinstagram_get_thread— Get messages (auto-paginates 500+ messages)instagram_get_pending— List pending DM requestsinstagram_user_info— Get any user's profileinstagram_thread_info— Thread metadata and participants
Send & Manage
instagram_send_message— Send text messagesinstagram_send_link— Share URLs with optional captioninstagram_create_thread— Start new DMs with one or multiple usersinstagram_like_message— React with any emojiinstagram_unsend_message— Unsend your messagesinstagram_mark_seen— Mark conversations as readinstagram_approve_pending— Approve pending requests
Search & Discover
instagram_search_inbox— Search conversations by usernameinstagram_search_messages— Find messages containing specific textinstagram_search_users— Search Instagram users
Quick Start
npx mcp-instagram-dm
Setup takes 60 seconds: grab 3 cookies from Chrome DevTools, add to your MCP config, done.
Design Principles
- Single dependency — only
@modelcontextprotocol/sdk - TypeScript strict — zero
anytypes - Auto-pagination — fetch 500+ messages with rate limiting
- 14+ message types — text, media, voice, reels, GIFs, stories, and more
- Cookie-based auth — no API keys, no OAuth
Server Config
{
"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"
}
}
}
}