Instagram DM MCP server

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.

mcp.comp.mp4

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

Hackathon Submission

Submit -> https://tally.so/r/mR18zl

Note: submisions due by Friday 27 June 11:59PM PST

Three cash prizes up for grabs

1. $5k USD - Breaking the internet (go viral AF)
2. $2.5k USD - Technical Sorcery (coolest technical implementation)
3. $2.5k USD - Holy Sh*t Award (make our jaws drop)

Installation

Prerequisites

• Python 3.11+
• Anthropic Claude Desktop app (or Cursor)
• Pip (Python package manager), install with python -m pip install
• An instagram account

Steps

1. Clone this repository

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

2. Connect to the MCP server

   Copy the below json with the appropriate {{PATH}} values and {{API KEY}}:

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

   For Claude Desktop:

   Save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

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

   For Cursor:

   Save this as mcp.json in your Cursor configuration directory at:

   ~/.cursor/mcp.json
   

3. Restart Claude Desktop / Cursor

   Open Claude Desktop and you should now see the Instagram DM MCP as an available integration.

   Or restart Cursor.

---

Troubleshooting

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

---

Feedback

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

---

License

This project is licensed under the MIT License.