Instagram Direct Messages

🚀 Instagram Direct Message MCP Server

An Instagram Direct Message Model-Consumer Protocol (MCP) server built with fastmcp and instagrapi. This server enables AI assistants to read and send Instagram direct messages.

Current Version: 1.3.5

🚀 Quick Start

The Instagram Direct Message MCP Server allows AI assistants to interact with Instagram's direct messaging feature. It's built with fastmcp and instagrapi, providing a seamless experience for managing direct messages.

✨ Features

• Read recent direct messages in the Instagram inbox with full conversation details.
• Send direct messages to Instagram users.
• Simple greeting resource (example feature).
• Health check endpoint with status information.
• Use stderr for proper logging to avoid JSON parsing issues.
• Support multiple authentication methods, including environment variables.

📦 Installation

As an npm Package (Recommended)

1. Install the package globally:

npm install -g instagram-dm-mcp

2. Run the setup script to install Python dependencies:

instagram-dm-mcp-setup

3. Register the server with Claude Desktop and configure credentials using the following command:

instagram-dm-mcp install

You will be prompted to paste your Instagram cookies information. If you're unsure how to obtain this information, follow these steps: Log in to Instagram in Chrome, right-click on the page, and select "Inspect". Go to the "Application" tab, then click "Cookies" in the left sidebar. You should see a list of cookies. Copy the values of sessionid, csrftoken, and ds_user_id.

The install command automatically registers the Instagram DM MCP server with Claude Desktop and adds it to your Claude Desktop configuration file. This command configures the server to use the npx method, making it easier to maintain. You can also copy and paste the same settings into Claude or any other MCP client.

You can provide Instagram credentials in multiple ways:

• Using command-line arguments:

  instagram-dm-mcp install --session-id YOUR_SESSION_ID --csrf-token YOUR_CSRF_TOKEN --ds-user-id YOUR_DS_USER_ID
  

• Using a credentials file:

  instagram-dm-mcp install --from-file /path/to/instagram_cookies.json
  

• Using environment variables (INSTAGRAM_SESSION_ID, INSTAGRAM_CSRF_TOKEN, and INSTAGRAM_DS_USER_ID)

The installer will add these credentials as environment variables in the Claude Desktop configuration file, generating the following configuration:

"mcpServers": {
  // Other servers...
  "InstagramDM": {
    "command": "npx",
    "args": [
      "-y",
      "instagram-dm-mcp",
      "start"
    ],
    "env": {
      "INSTAGRAM_SESSION_ID": "your-session-id",
      "INSTAGRAM_CSRF_TOKEN": "your-csrf-token",
      "INSTAGRAM_DS_USER_ID": "your-ds-user-id"
    }
  }
}