Instagram MCP logo

Instagram MCP

Connects AI agents to Instagram Business accounts for publishing, analytics, comments, hashtags, stories, and messaging.

Install Instagram MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "instagram-mcp-2": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpware/claude-code-organizer"
      ],
      "env": {
        "FACEBOOK_APP_ID": "YOUR_VALUE_HERE",
        "FACEBOOK_APP_SECRET": "YOUR_VALUE_HERE",
        "INSTAGRAM_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "INSTAGRAM_BUSINESS_ACCOUNT_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @mcpware/claude-code-organizer

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 20d ago.

Overview

The instagram-mcp MCP server connects AI applications to Instagram's Graph API for Business accounts. It exposes tools for profile data, media publishing, insights, comments, stories, hashtags, business discovery, and direct messages, with some messaging features requiring Meta Advanced Access. Reach for it when an agent needs to inspect or manage an Instagram Business account programmatically through MCP.

Use cases

  • Publish Instagram images, videos, carousels, and Reels
  • Analyze account and post engagement metrics
  • Moderate comments and reply to audience messages
  • Read and send Instagram direct messages
  • Research hashtags, mentions, stories, and business accounts

Key features

  • Instagram Business profile and media access
  • Account and post insights
  • Image, video, carousel, and Reel publishing
  • Comment moderation and replies
  • Direct-message conversations
  • Hashtag, story, mention, and business discovery

Tools23

What Instagram MCP lets your agent do. Expand a tool for its parameters.

Self-reported~248 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @mcpware/claude-code-organizer (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars61Stargazers on the source repository.
npm downloads403Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed23Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Instagram MCP works

What instagram-mcp does

The instagram-mcp MCP server gives AI applications access to Instagram Business account operations through the Instagram Graph API. It covers account information, connected Facebook Pages, account and post analytics, content publishing, comments, stories, mentions, hashtags, and business-account lookup.

The server also exposes Instagram direct-message operations: listing conversations, reading conversation messages, and sending DMs. These features depend on the instagram_manage_messages permission and Meta Advanced Access approval.

In addition to model-controlled tools, the project documents application-controlled resources for profile data, a media feed, and insights data. It also includes user-controlled prompts for engagement analysis, content strategy, and hashtag analysis.

How it works

An MCP client calls the server's tools, which use credentials for an Instagram Business account connected to a Facebook Page. The account must be associated with a Facebook Developer app and an access token with the permissions required by the requested operation.

Available operations include reading profile and media information, checking token validity, reviewing publishing limits, publishing single media items, publishing carousels of two to ten items, and publishing Reels. Engagement workflows can retrieve, create, reply to, delete, or hide comments. Discovery tools can search hashtag IDs, retrieve hashtag media, inspect active stories, find mentions, and look up another business account.

Setup and configuration

The instagram-mcp MCP server requires an Instagram Business account connected to a Facebook Page, a Facebook Developer account, and a long-lived access token. Python 3.10 or newer is required by the MCP dependencies.

Set these values in the environment before starting the server:

  • FACEBOOK_APP_ID: Facebook app identifier.
  • FACEBOOK_APP_SECRET: Facebook app secret.
  • INSTAGRAM_ACCESS_TOKEN: Long-lived Instagram access token.
  • INSTAGRAM_BUSINESS_ACCOUNT_ID: Instagram Business account ID.

The documented configuration also supports INSTAGRAM_API_VERSION, RATE_LIMIT_REQUESTS_PER_HOUR, CACHE_ENABLED, and LOG_LEVEL. The README recommends keeping secrets out of source control, using secure secret management, rotating tokens, and monitoring expiration. Long-lived tokens expire after 60 days, so token validity and refresh handling need to be part of an operational setup.

The listed standard permissions cover profile access, content publishing, insights, comments, Page access, and related account operations. Direct messaging requires the separate instagram_manage_messages permission and Meta App Review approval.

Tools and capabilities

The 23 tools include:

  • Profile, connected Page, token validation, account-insights, and publishing-limit checks.
  • Recent media retrieval and per-post insights.
  • Image or video publishing, carousel publishing, and Reel publishing.
  • Comment retrieval, posting, replies, deletion, and hide/unhide actions.
  • Conversation listing, message retrieval, and DM sending.
  • Hashtag search and hashtag-media retrieval.
  • Active-story retrieval, mention lookup, and business discovery.

For a Social Media workflow, this makes the server suitable for combining content operations with account measurement and audience interaction, provided the connected account and token have the necessary permissions.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Instagram MCP

instagram-mcp is an MCP server that connects AI applications to Instagram's Graph API for Business accounts. Its main tools retrieve profiles, posts, insights, comments, stories, hashtags, mentions, and conversations, and can publish media, moderate comments, send DMs, check tokens, and discover business accounts.

Use Python 3.10 or newer and configure the required Facebook and Instagram credentials before running the server.

It needs a Facebook App ID, Facebook App Secret, long-lived Instagram access token, and Instagram Business Account ID. The Instagram account must be a Business account connected to a Facebook Page, and the token must include permissions for the operations you plan to use.

Yes, it can list conversations, read conversation messages, and send DMs when the account has the required access. Direct messaging requires the `instagram_manage_messages` permission and Advanced Access approval from Meta.

Yes, it can publish images or videos, carousels containing two to ten images or videos, and Reels. Publishing requires the appropriate Instagram content-publishing permission and a connected Instagram Business account.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInstagram MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/instagram-mcp-2?style=directory)](https://allmcps.com/mcp/instagram-mcp-2)
HTML Embed
<a href="https://allmcps.com/mcp/instagram-mcp-2"><img src="https://allmcps.com/api/badge/instagram-mcp-2?style=directory" alt="Instagram MCP on AllMCPs" /></a>