communication

Instagram Direct Messages▌

by taskmaster-ai

Access and manage your Instagram Direct Messages with a Python server. Send, read, and retrieve conversations easily usi

Enables reading and sending Instagram direct messages through a Python server that authenticates with Instagram cookies and provides tools for retrieving recent conversations and sending new messages.

github stars

★ 18

GitHub npm

Uses Instagram cookies for authenticationNo official API required

best for

/ AI assistants managing Instagram communications
/ Automating Instagram customer support
/ Social media management workflows

capabilities

/ Read recent Instagram direct messages
/ Send direct messages to Instagram users
/ Retrieve comprehensive thread information
/ Check server health status

what it does

Enables AI assistants to read your Instagram direct messages and send new DMs by authenticating with your Instagram cookies.

about

Instagram Direct Messages is a community-built MCP server published by taskmaster-ai that provides AI assistants with tools and capabilities via the Model Context Protocol. Access and manage your Instagram Direct Messages with a Python server. Send, read, and retrieve conversations easily usi It is categorized under communication.

how to install

You can install Instagram Direct Messages in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Instagram Direct Messages is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Instagram DM MCP Server

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

Current Version: 1.3.5

Features

Read recent direct messages from your Instagram inbox with comprehensive thread information
Send direct messages to Instagram users
Simple greeting resource (example functionality)
Health check endpoint with status information
Proper logging to stderr to avoid JSON parsing issues
Support for various authentication methods, including environment variables

Installation

As an npm package (recommended)

Install the package globally:

npm install -g instagram-dm-mcp

Run the setup script to install Python dependencies:

instagram-dm-mcp-setup

instagram-dm-mcp install

You will be prompted to paste in your Instagram cookies information. If you arne't sure how to get this, log into Instagram on Chrome, right-click on the page, and select "Inspect". Go to the "Application" tab, then click on "Cookies" in the left sidebar. You should see a list of cookies. Copy the values for sessionid, csrftoken, and ds_user_id.

The install command will automatically register the Instagram DM MCP server with Claude Desktop and add it to your Claude Desktop configuration file. The command will configure the server to use the npx approach, which makes it easier to maintain. You can also copy-paste the same setup to Claude or any other MCP client.

You can provide Instagram credentials in several 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, creating a configuration like this:

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