ig-mcp

Overview

The ig-mcp server provides comprehensive access to Instagram's business features through MCP tools, resources, and prompts. It enables profile information retrieval, media management, publishing capabilities, conversation handling, and analytics. The server includes robust authentication handling with clear documentation for both standard and advanced access levels. The codebase is well-structured with proper error handling, rate limiting, and security considerations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• Get Profile Info

  Retrieve Instagram business profile details

  Try:Can you get my Instagram profile information?Try:Show me my business account details
• Get Media Posts

  Fetch recent posts from an Instagram account

  Try:Show me my last 5 Instagram postsTry:Get my recent media content
• Get Media Insights

  Retrieve engagement metrics for specific posts

  Try:Analyze engagement for my latest postTry:Show me insights for this post
• Publish Media

  Upload and publish images/videos to Instagram

  Try:Upload this image to Instagram with caption 'Beautiful sunset!'Try:Publish this video to my Instagram account
• Get Account Pages

  List Facebook pages connected to the account

  Try:Show me connected Facebook pagesTry:List all linked business accounts
• Get Conversations

  List Instagram DM conversations (requires Advanced Access)

  Try:Show my Instagram DM conversationsTry:List all message threads
• Get Conversation Messages

  Read messages from specific conversations (requires Advanced Access)

  Try:Show messages from this conversationTry:Read the latest DMs
• Send DM

  Reply to Instagram direct messages (requires Advanced Access)

  Try:Send a reply to this DMTry:Send this message to the conversation

Comparable tools

Installation

git clone <repository-url>
cd ig-mcp

pip install -r requirements.txt

cp .env.example .env
# Edit .env with your Instagram API credentials

# Edit config.json with your specific settings

{
  "mcpServers": {
    "instagram": {
      "command": "python",
      "args": ["/path/to/ig-mcp/src/instagram_mcp_server.py"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

FAQ

What permissions are required for Instagram DM features?

Instagram direct messaging features require Advanced Access approval from Meta, specifically the 'instagram_manage_messages' permission, which needs to go through the App Review process.

How do I handle token expiration?

The server provides a refresh strategy using the Facebook Graph API to exchange expired tokens for new ones. Long-lived tokens expire after 60 days, so implement automatic refresh before expiration.

Compare ig-mcp with