instagram_dm_mcp

Overview

This is a fully-featured MCP server that bridges Instagram's messaging capabilities with AI assistants. It provides comprehensive functionality for sending messages (text, photos, videos), managing chats, accessing user information, and handling media content. The server includes automatic session management to maintain authentication state and offers both environment variable and command-line credential options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• send_message

  Send an Instagram direct message to a user by username.

  Try:Send a message to 'johndoe' saying 'Hello there!'Try:DM user 'sarahsmith' the link to the article
• send_photo_message

  Send a photo as an Instagram direct message to a user by username.

  Try:Send a photo to 'mikejohnson'Try:Share the sunset photo with 'alexturner'
• send_video_message

  Send a video as an Instagram direct message to a user by username.

  Try:Send the vacation video to 'lisawong'Try:Share the tutorial video with 'davidchen'
• list_chats

  Get Instagram Direct Message threads from your account.

  Try:Show me all my DM conversationsTry:List my recent chats
• list_messages

  Get messages from a specific Instagram DM thread by thread ID.

  Try:Show all messages in thread 12345Try:What's in the conversation with 'emilyjones'?
• download_media_from_message

  Download direct-uploaded photo or video from a DM message.

  Try:Download the photo from message 67890Try:Save the video from that DM to my computer
• mark_message_seen

  Mark a specific message in an Instagram DM thread as seen.

  Try:Mark message 54321 as readTry:Tell Instagram I've seen the last message in the thread
• search_threads

  Search Instagram DM threads by username or keyword.

  Try:Find threads with 'work' in themTry:Search for conversation with 'robertpattinson'
• get_user_info

  Get information about a specific Instagram user by username.

  Try:Get profile info for 'chrishemsworth'Try:Tell me about 'ninadobrev'
• get_user_id_from_username

  Get the Instagram user ID for a given username.

  Try:What's the user ID for 'tomholland'?Try:Find user ID for 'emmawatson'
• search_users

  Search for Instagram users by username.

  Try:Search for users named 'mike'Try:Find users with 'john' in their username
• get_user_posts

  Get recent posts from a specific Instagram user by username.

  Try:Show recent posts from 'arianagrande'Try:What posts has 'timothychalamet' shared recently?

Comparable tools

Installation

git clone https://github.com/trypeggy/instagram_dm_mcp.git
cd instagram_dm_mcp

uv sync

pip install -r requirements.txt

python setup_env.py

{
  "mcpServers": {
    "instagram_dms": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "PATH/TO/instagram_dm_mcp",
        "python",
        "src/mcp_server.py"
      ]
    }
  }
}

FAQ

Does this support Instagram Business accounts?

The README doesn't specify differences between personal and business accounts, so both should work as long as you have valid credentials.

Can I use this with AI assistants other than Claude?

While the example shows Claude Desktop integration, this should work with any MCP-compatible client that can connect to Python-based servers.

Compare instagram_dm_mcp with