Instagram MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/jlbadano/ig-mcp
cd ig-mcp
pip install -r requirements.txt
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "INSTAGRAM_ACCESS_TOKEN=${INSTAGRAM_ACCESS_TOKEN}" instagram-mcp-7b6f -- python "<FULL_PATH_TO_IG_MCP>/dist/index.js"

Replace <FULL_PATH_TO_IG_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:INSTAGRAM_ACCESS_TOKEN
README.md

Integrate with Instagram's Graph API for AI-driven account management.

Instagram MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Instagram's Graph API, enabling AI applications to interact with Instagram Business accounts programmatically.

Features

🔧 Tools (Model-controlled)

  • Get Profile Info: Retrieve Instagram business profile details
  • Get Media Posts: Fetch recent posts from an Instagram account
  • Get Media Insights: Retrieve engagement metrics for specific posts
  • Publish Media: Upload and publish images/videos to Instagram
  • Get Account Pages: List Facebook pages connected to the account
  • Get Conversations: List Instagram DM conversations (requires Advanced Access)
  • Get Conversation Messages: Read messages from specific conversations (requires Advanced Access)
  • Send DM: Reply to Instagram direct messages (requires Advanced Access)

📊 Resources (Application-controlled)

  • Profile Data: Access to profile information including follower counts, bio, etc.
  • Media Feed: Recent posts with engagement metrics
  • Insights Data: Detailed analytics for posts and account performance

💬 Prompts (User-controlled)

  • Analyze Engagement: Pre-built prompt for analyzing post performance
  • Content Strategy: Template for generating content recommendations
  • Hashtag Analysis: Prompt for hashtag performance evaluation

Prerequisites

  1. Instagram Business Account: Must be connected to a Facebook Page
  2. Facebook Developer Account: Required for API access
  3. Access Token: Long-lived access token with appropriate permissions
  4. Python 3.10+: For running the MCP server (required by MCP dependencies)

Required Instagram API Permissions

Standard Access (available immediately):

  • instagram_basic
  • instagram_content_publish
  • instagram_manage_insights
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement
  • pages_manage_metadata
  • pages_read_user_content
  • business_management

Advanced Access (requires Meta App Review):

  • instagram_manage_messages - Required for Direct Messaging features

⚠️ Instagram DM Features: Reading and sending Instagram direct messages requires Advanced Access approval from Meta. See INSTAGRAM_DM_SETUP.md for the App Review process.

🔑 How to Get Instagram API Credentials

📖 Quick Start: See AUTHENTICATION_GUIDE.md for a 5-minute setup guide!

This section provides a step-by-step guide to obtain the necessary credentials for the Instagram MCP server.

Step 1: Set Up Instagram Business Account

  1. Convert to Business Account (if not already):

    • Open Instagram app → Settings → Account → Switch to Professional Account
    • Choose "Business" → Select a category → Complete setup

  2. Connect to Facebook Page:

    • Go to Instagram Settings → Account → Linked Accounts → Facebook
    • Connect to an existing Facebook Page or create a new one
    • Important: The Facebook Page must be owned by you

Step 2: Create Facebook App

  1. Go to Facebook Developers:

  2. Create New App:

    • Click "Create App" → Choose "Business" → Click "Next"
    • Fill in app details:
      • App Name: Choose a descriptive name (e.g., "My Instagram MCP Server")
      • App Contact Email: Your email address
    • Click "Create App"

  3. Add Instagram Basic Display Product:

    • In your app dashboard, click "Add Product"
    • Find "Instagram Basic Display" → Click "Set Up"

  4. Configure Instagram Basic Display:

    • Go to Instagram Basic Display → Basic Display
    • Click "Create New App" in the Instagram App section
    • Accept the terms and create the app

Step 3: Get App Credentials

  1. Get App ID and Secret:
    • In your Facebook app dashboard, go to Settings → Basic
    • Copy your App ID and App Secret
    • Important: Keep the App Secret secure and never share it publicly

Step 4: Set Up Instagram Business API Access

  1. Add Instagram Graph API Product:

    • In your app dashboard, click "Add Product"
    • Find "Instagram Graph API" → Click "Set Up"

  2. Configure Permissions:

    • Go to Instagram Graph API → Permissions
    • Request the following permissions:
      • instagram_basic
      • instagram_content_publish
      • instagram_manage_insights
      • pages_show_list
      • pages_read_engagement

Step 5: Generate Access Token

Option A: Using Facebook Graph API Explorer (Recommended for Testing)
  1. Go to Graph API Explorer:

Tools (8)

get_profile_infoRetrieve Instagram business profile details
get_media_postsFetch recent posts from an Instagram account
get_media_insightsRetrieve engagement metrics for specific posts
publish_mediaUpload and publish images/videos to Instagram
get_account_pagesList Facebook pages connected to the account
get_conversationsList Instagram DM conversations
get_conversation_messagesRead messages from specific conversations
send_dmReply to Instagram direct messages

Environment Variables

INSTAGRAM_ACCESS_TOKENrequiredLong-lived access token with appropriate permissions

Configuration

claude_desktop_config.json
{"mcpServers": {"instagram": {"command": "python", "args": ["path/to/ig-mcp/main.py"], "env": {"INSTAGRAM_ACCESS_TOKEN": "your_token_here"}}}}

Try it

→Analyze the engagement metrics for my most recent Instagram post.
→Draft a new Instagram post about our latest product launch and publish it.
→List my recent Instagram DM conversations and summarize the pending inquiries.
→What is the current follower count and bio for my business profile?
→Find the top performing post from last week based on engagement insights.

Frequently Asked Questions

What are the key features of Instagram MCP Server?

Retrieve Instagram business profile details and metrics. Fetch and analyze engagement data for media posts. Programmatically publish images and videos to Instagram. Manage and respond to Instagram direct messages. List and manage Facebook pages linked to the Instagram account.

What can I use Instagram MCP Server for?

Automating social media performance reporting for marketing teams. Scheduling and publishing content directly from AI workflows. Streamlining customer support by managing DMs through an AI interface. Generating data-driven content strategies based on historical post insights.

How do I install Instagram MCP Server?

Install Instagram MCP Server by running: git clone https://github.com/jlbadano/ig-mcp && cd ig-mcp && pip install -r requirements.txt

What MCP clients work with Instagram MCP Server?

Instagram MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Instagram MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all communication servers →

Related MCP Servers

Vexa
Self-hosted meeting intelligence platform
communication1.8K stars
Claude Peers
Let your Claude Code instances find each other and talk.
communication1.8K stars
Wenyan MCP Server
Bridge AI writing and WeChat Official Account publishing with Markdown.
communication1.1K stars
KeyID Agent Kit
Give Claude, Cursor, or any MCP client a real email address. Free.
communication546 stars
WeChat MCP Server
A WeChat robot server that enables AI agents to send and receive messages.
communication78 stars
MCP Microsoft Office
Connects AI assistants to Microsoft 365 accounts to manage M365 workflows.
communication38 stars

Compare Instagram MCP Server with Alternatives

Instagram MCP Server vs VexaInstagram MCP Server vs Claude PeersInstagram MCP Server vs Wenyan MCP ServerInstagram MCP Server vs KeyID Agent Kit