social

Instagram MCP Server

Instagram MCP setup for Claude: publish posts, read insights, and reply to DMs on a Business account via the official Graph API. No official Meta server yet.

Pricing
free
GitHub stars
191
Last commit
2026-02-09
Page updated

Free and open source (MIT). The Instagram Graph API is free, but you need a Business account and a Meta developer app.

View on GitHub
git clone https://github.com/jlbadano/ig-mcp
Website

Meta has no official MCP server for organic Instagram. Its Meta Ads MCP runs Instagram ads, but it won't publish a post or read your comments. For organic work you need a community server built on the Instagram Graph API.

jlbadano/ig-mcp is a solid, simple pick. It's Python, MIT-licensed, and covers the basics a social manager needs: profile and follower data, recent posts, per-post insights, publishing images and videos, and DMs. It also ships prompt templates for engagement analysis, content strategy and hashtag reviews.

A workflow I'd use: every Friday, ask Claude to pull the last 20 posts with reach, saves and shares, rank them by saves per 1,000 reach, and draft next week's captions in the style of the top three. You approve, and Claude publishes. Pair it with Canva for the visuals.

Setup is the annoying part. You need an Instagram Business account linked to a Facebook Page, a Meta developer app, and a long-lived access token. That token expires after 60 days, so put a reminder in your calendar. DM tools need Meta's App Review for Advanced Access, and publishing is capped at 25 posts per day by the API.

What you can ask it

  • “Pull my last 20 posts with reach, saves and shares, and rank them by saves per 1,000 reach”
  • “Which of my Reels from the last 60 days had the best share rate, and what do their hooks have in common?”
  • “Draft 5 captions for next week in the voice of my three best-performing posts”
  • “Publish this image with the caption I approved above”
  • “Summarize my unread DMs and flag anything that looks like a sales lead”
  • “Run a hashtag analysis on my last 30 posts and tell me which tags I should drop”

Features

  • Get business profile details, follower counts and bio
  • Fetch recent posts with engagement metrics
  • Pull engagement insights for specific posts (likes, comments, shares) plus account reach and impressions
  • Publish images and videos to your Instagram Business account
  • List, read and reply to DMs (needs Meta Advanced Access)
  • Built-in prompts for engagement analysis, content strategy and hashtag performance
  • Rate limiting built in: 200 calls per hour and 25 posts per day

How to set up the Instagram MCP Server

Works with: Claude Desktop, Claude Code

1. Switch your Instagram account to a Business account and link it to a Facebook Page you own. 2. Create a Business-type app at developers.facebook.com and request these permissions: instagram_basic, instagram_content_publish, instagram_manage_insights, pages_show_list, pages_read_engagement. For DMs, also request instagram_manage_messages, which needs App Review. 3. Generate a token in the Graph API Explorer, then exchange it for a long-lived token (60 days). Get your Instagram Business Account ID by calling /{page-id}?fields=instagram_business_account. 4. Install the server (Python 3.10+):
git clone https://github.com/jlbadano/ig-mcp.git
cd ig-mcp
pip install -r requirements.txt
cp .env.example .env
Fill in .env with INSTAGRAM_ACCESS_TOKEN, FACEBOOK_APP_ID, FACEBOOK_APP_SECRET and INSTAGRAM_BUSINESS_ACCOUNT_ID. 5. Claude Desktop: add this to your config:
{
  "mcpServers": {
    "instagram": {
      "command": "python",
      "args": ["/path/to/ig-mcp/src/instagram_mcp_server.py"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}
6. Claude Code:
claude mcp add instagram -e INSTAGRAM_ACCESS_TOKEN=your_access_token -- python /path/to/ig-mcp/src/instagram_mcp_server.py
7. Restart and ask "Get my Instagram profile information" to confirm it's connected.

Alternatives

mikusnuz/meta-mcp

Larger Graph API server with 57 tools that also covers Threads, handy if you post to both.

Meta Ads MCP (official)

Meta's official hosted server for Instagram and Facebook ads. It covers paid campaigns, not organic posting.

FAQ

Is there an official Instagram MCP server?
Not for organic content. Meta's only official MCP is the Meta Ads MCP, which manages Facebook and Instagram ads but doesn't publish posts or read comments.
Can I use an Instagram MCP with a personal account?
No. The Graph API only works with Business accounts (this server needs a Business account linked to a Facebook Page). Switching is free in the Instagram app settings.
Can Claude post to Instagram for me?
Yes, with this server's publish tool. The API limits you to 25 posts per day, and the image or video must be at a public URL Instagram can fetch.
Is the Instagram MCP safe to use?
It talks to Meta's official Graph API with a token you generate, so there's no scraping or fake logins involved. Keep that token out of shared configs and rotate it before the 60-day expiry.
Why can't the Instagram MCP read my DMs?
DM tools need the instagram_manage_messages permission with Advanced Access, which requires Meta's App Review. Everything else works with standard access.

Added: 2026-02-26 · Last reviewed: 2026-09-22