Instagram MCP
A production-ready Model Context Protocol (MCP) server that enables AI applications to seamlessly interact with Instagram Business accounts.
What is Instagram MCP?
Instagram MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-ready model context protocol (mcp) server that enables ai applications to seamlessly interact with instagram business accounts.
A production-ready Model Context Protocol (MCP) server that enables AI applications to seamlessly interact with Instagram Business accounts.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A production-ready Model Context Protocol (MCP) server that
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx igConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Instagram MCP
The Instagram MCP Server is a production-ready Model Context Protocol server that connects AI assistants to Instagram Business accounts via the Meta Graph API. It allows you to retrieve profile data, fetch post engagement metrics, upload media, manage direct messages, and analyze content performance—all through natural language requests. This is ideal for social media managers and developers who want to automate Instagram workflows or build AI-powered content analytics tools.
Prerequisites
- Python 3.9 or higher installed
- An Instagram Business account connected to a Facebook Page
- Meta App with Instagram Graph API access (App ID and App Secret)
- A long-lived Instagram Access Token and your Instagram Business Account ID
- An MCP-compatible client such as Claude Desktop
Clone the repository
Clone the ig-mcp repository from GitHub and navigate into the project directory.
git clone https://github.com/jlbadano/ig-mcp.git
cd ig-mcpInstall Python dependencies
Install all required Python packages listed in requirements.txt.
pip install -r requirements.txtConfigure environment variables
Copy the example environment file and fill in your Meta App credentials and Instagram account details.
cp .env.example .envSet required credentials in .env
Open .env and set the four required variables: your long-lived access token, Facebook App ID and Secret, and your Instagram Business Account ID. Optionally set INSTAGRAM_API_VERSION (default v19.0), RATE_LIMIT_REQUESTS_PER_HOUR, CACHE_ENABLED, and LOG_LEVEL.
INSTAGRAM_ACCESS_TOKEN=your_long_lived_token
FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret
INSTAGRAM_BUSINESS_ACCOUNT_ID=your_account_idConfigure your MCP client
Add the server to your MCP client configuration. The server runs as a Python script using stdio transport.
Start using the server
With the configuration in place, restart your MCP client and begin interacting with your Instagram Business account through the AI assistant.
Instagram MCP Examples
Client configuration
Add this to your claude_desktop_config.json to connect Claude Desktop to the Instagram MCP server.
{
"mcpServers": {
"instagram": {
"command": "python",
"args": ["/path/to/ig-mcp/server.py"],
"env": {
"INSTAGRAM_ACCESS_TOKEN": "your_long_lived_token",
"FACEBOOK_APP_ID": "your_app_id",
"FACEBOOK_APP_SECRET": "your_app_secret",
"INSTAGRAM_BUSINESS_ACCOUNT_ID": "your_account_id"
}
}
}
}Prompts to try
Example prompts you can use with Claude after connecting the Instagram MCP server.
- "Get my Instagram profile information and follower count"
- "Show me my last 5 Instagram posts and their engagement metrics"
- "What are the engagement rates on my recent posts?"
- "Upload this image to my Instagram account with the caption 'New product launch!'"
- "List all my connected Facebook pages"Troubleshooting Instagram MCP
Access token errors or 'OAuthException' responses
Instagram access tokens expire. Generate a new long-lived token through the Meta Developer portal (valid for 60 days) and update INSTAGRAM_ACCESS_TOKEN in your .env file. Short-lived tokens last only 1 hour.
DM tools return 'Advanced Access required' error
Reading and replying to direct messages requires Advanced Access on your Meta App, which requires a business verification process with Meta. Basic Access only allows profile and post data retrieval.
Rate limit errors when fetching data
The Meta Graph API enforces rate limits per token. Set RATE_LIMIT_REQUESTS_PER_HOUR in .env to a conservative value (e.g., 100) and enable CACHE_ENABLED=true to reduce redundant API calls.
Frequently Asked Questions about Instagram MCP
What is Instagram MCP?
Instagram MCP is a Model Context Protocol (MCP) server that production-ready model context protocol (mcp) server that enables ai applications to seamlessly interact with instagram business accounts. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Instagram MCP?
Follow the installation instructions on the Instagram MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Instagram MCP?
Instagram MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Instagram MCP free to use?
Yes, Instagram MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Instagram MCP Alternatives — Similar Communication Servers
Looking for alternatives to Instagram MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Instagram MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Instagram MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.