Instagram DMs

by trypeggy

194 downloads

Not rated

GitHub

About

This is a Model Context Protocol (MCP) server for sending Instagram Direct Messages.

Details

Author: trypeggy
Downloads: 194
Categories: Communication, Community, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Instagram DMs

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

From the repository

—

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "instagram dms": {
            "instagram_dms": {
                "command": "python",
                "args": [
                    "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
                    "--username",
                    "{{YOUR_INSTAGRAM_USERNAME}}",
                    "--password",
                    "{{YOUR_INSTAGRAM_PASSWORD}}"
                ]
            }
        }
    }
}

McpServers

{
    "instagram_dms": {
        "command": "python",
        "args": [
            "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py",
            "--username",
            "{{YOUR_INSTAGRAM_USERNAME}}",
            "--password",
            "{{YOUR_INSTAGRAM_PASSWORD}}"
        ]
    }
}

This is a Model Context Protocol (MCP) server for sending instagram Direct Messages.

With this you can send Instagram Direct Messages from your account (more capabilities coming soon).

Here's an example of what you can do when it's connected to Claude.

To get updates on this and other projects we work onenter your email here

- Python 3.11+
- Anthropic Claude Desktop app (or Cursor)
- Pip (Python package manager), install withpython -m pip install
- An instagram account
- Clone this repository

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

- Configure Instagram credentialsYou have two options for providing your Instagram credentials:Option A: Environment Variables (Recommended)Quick Setup (Recommended):Run the helper script:

python setup_env.py

INSTAGRAM_USERNAME=your_instagram_username INSTAGRAM_PASSWORD=your_instagram_password

~/Library/Application Support/Claude/claude_desktop_config.json

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

{ "mcpServers": { "instagram_dms": { "command": "python", "args": [ "{{PATH_TO_SRC}}/instagram_dm_mcp/src/ mcp_server.py" ] } } }

{ "mcpServers": { "instagram_dms": { "command": "python", "args": [ "{{PATH_TO_SRC}}/instagram_dm_mcp/src/mcp_server.py", "--username", "{{YOUR_INSTAGRAM_USERNAME}}", "--password", "{{YOUR_INSTAGRAM_PASSWORD}}" ] } } }

Below is a list of all available tools and what they do:

Instagram Login Hanging:The server now includes automatic session management to prevent login hangs. Session files (e.g.,username_session.json) are automatically created and reused to maintain authentication state between runs.

For additional Claude Desktop integration troubleshooting, see theMCP documentation. The documentation includes helpful tips for checking logs and resolving common issues.

Your feedback will be massively appreciated. Please tell uswhich features on that list you like to see next or request entirely new ones.

This project is licensed under the MIT License.

Chat with any other OpenAI SDK Compatible Chat Completions API, like Perplexity, Groq, xAI and more

BGG MCP enables AI tools to interact with the BoardGameGeek API.

integrates with Bluesky API to query and search feeds and posts.

This server enables users to send emails through various email providers, including Gmail, Outlook, Yahoo, Sina, Sohu, 126, 163, and QQ Mail. It also supports attaching files from specified directories, making it easy to upload attachments along with the email content.

MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.

An MCP server application that sends various types of messages to the WeCom group robot.

An IMAP Model Context Protocol (MCP) server to expose IMAP operations as tools for AI assistants.

Enables interactive LLM workflows by adding local user prompts and chat capabilities directly into the MCP loop.

Connect AI assistants like Cursor to Google Chat and beyond — enabling smart, extensible collaboration across chat platforms.

An ntfy MCP server for sending/fetching ntfy notifications to your self-hosted ntfy server from AI Agents 📤 (supports secure token auth & more - use with npx or docker!)

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Instagram DMs

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Slack

Filesystem

EverArt

Google Drive

Reactive Resume