https://github.com/trypeggy/instagram_dm_mcp
https://github.com/trypeggy/instagram_dm_mcp
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/trypeggy/instagram_dm_mcp
- Owner: trypeggy
- License: mit
- Created: 2025-06-19T00:22:00.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-19T00:37:58.000Z (4 months ago)
- Last Synced: 2025-06-19T01:31:59.552Z (4 months ago)
- Language: Python
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **Instagram DMs** - Send Instagram DMs via your LLM `http` `llm` `git` `github` (Other)
- awesome-mcp-servers - **Instagram DMs** - Send Instagram DMs via your LLM `http` `llm` `git` `github` (Other)
- awesome-mcp-servers - Instagram DMs - Send Instagram DMs via your LLM (Community Servers)
README
# 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.
https://github.com/user-attachments/assets/9c945f25-4484-4223-8d6b-5bf31243464c
> To get updates on this and other projects we work on [enter your email here](https://tally.so/r/np6rYy)
PS: Join our [Twitter community](https://twitter.com/i/communities/1937504082635170114) for all things MCP
---
## Hackathon Submission
[](https://tally.so/r/mR18zl)
### 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)
> Note: submisions due by Friday 27 June 11:59PM PST
---
## 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**
```bash
git clone https://github.com/trypeggy/instagram_dm_mcp.git
cd instagram_dm_mcp
```
2. **Install dependencies**
```bash
pip install -r requirements.txt
```
3. **Connect to the MCP server**
Copy the below json with the appropriate `{{PATH}}` values, `{{YOUR_INSTAGRAM_USERNAME}}` and `{{YOUR_INSTAGRAM_PASSWORD}}`:
```json
{
"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
```
4. **Restart Claude Desktop / Cursor**
Open Claude Desktop and you should now see the Instagram DM MCP as an available integration.
Or restart Cursor.
---
## Usage
Below is a list of all available tools and what they do:
| Tool Name | Description |
|-----------------------------|-----------------------------------------------------------------------------------------------|
| `send_message` | Send an Instagram direct message to a user by username. |
| `list_chats` | Get Instagram Direct Message threads (chats) from your account, with optional filters/limits. |
| `list_messages` | Get messages from a specific Instagram Direct Message thread by thread ID. |
| `list_pending_chats` | Get Instagram Direct Message threads from your pending inbox. |
| `search_threads` | Search Instagram Direct Message threads by username or keyword. |
| `get_thread_by_participants`| Get an Instagram Direct Message thread by participant user IDs. |
| `get_thread_details` | Get details and messages for a specific Instagram Direct Message thread by thread ID. |
| `get_user_id_from_username` | Get the Instagram user ID for a given username. |
| `get_username_from_user_id` | Get the Instagram username for a given user ID. |
---
## Troubleshooting
For additional Claude Desktop integration troubleshooting, see the [MCP documentation](https://modelcontextprotocol.io/quickstart/server#claude-for-desktop-integration-issues). The documentation includes helpful tips for checking logs and resolving common issues.
---
## Feedback
Your feedback will be massively appreciated. Please [tell us](mailto:tanmay@usegala.com) which features on that list you like to see next or request entirely new ones.
---
## License
This project is licensed under the MIT License.
