v1.0 β Instagram Control MCP Server
π€ Instagram Control MCP Server β v1.0
Full-featured MCP server to let any AI agent (Claude, Cursor, etc.) control a real Instagram account using the private mobile API.
β¨ Features
- 68 tools covering every Instagram action
- Session persistence β auto-restores login between runs
- Cookie/sessionid login (bypasses 2FA)
- Username + password login with 2FA/challenge support
π¦ What's Included
| Category | Tools |
|---|---|
| Authentication | Login, logout, 2FA, session cookie |
| Profile | Get, edit bio/name/URL, change picture |
| Feed Posts | Photo, video, reel, album, delete, pin, archive, edit caption |
| Post Control | Usertags, hashtags, mentions, location, alt-text, disable comments |
| Stories | Photo/video stories with stickers (mentions, hashtags, location, link) |
| Highlights | Get, create, delete |
| Engagement | Like, unlike, save, unsave, comment, reply, delete comment, like comment |
| Following | Follow, unfollow, get followers/following, block/unblock |
| DMs | Threads, messages, send text/photo/video, mark seen |
| Search | Users, hashtags (recent + top), location posts, similar accounts |
| Notifications | Activity feed, pending follow requests |
π Quick Start
git clone https://github.com/official-Arvind/instagram-mcp.git
cd instagram-mcp
python -m venv venv
venv\Scripts\pip install -r requirements.txtβοΈ Claude Desktop Config
{
"mcpServers": {
"instagram-control": {
"command": "C:\\path\\to\\instagram-mcp\\venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\instagram-mcp\\mcp_server.py"]
}
}
}β οΈ Disclaimer
Uses Instagram's unofficial private API. Use responsibly.