Instagram MCP server
Instagram MCP — 23 tools for Instagram Graph API: posts, DMs, stories, reels, analytics.
42 stars139 downloads/wk
Reviews
Write oneNobody has reviewed Instagram yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Instagram tools (23, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
business_discoveryLook up another public Business or Creator account's profile. Returns bio, follower count, media count, etc.
delete_commentwrite actionDelete a comment on your Instagram post. Can only delete comments on your own media.
get_account_insightsGet account-level insights and analytics for Instagram business account
get_account_pagesGet Facebook pages connected to the account and their Instagram business accounts
get_commentsGet comments on an Instagram post. Returns comment text, username, timestamp, and like count.
get_content_publishing_limitCheck how many posts you can still publish today. Instagram limits content publishing per 24-hour period.
get_conversation_messagesGet messages from a specific Instagram DM conversation. Requires instagram_manage_messages permission.
get_conversationsGet Instagram DM conversations. Requires instagram_manage_messages permission.
get_hashtag_mediaGet top or recent media for a hashtag. Use search_hashtag first to get the hashtag ID.
get_media_insightsGet detailed insights and analytics for a specific Instagram post
get_media_postsGet recent media posts from Instagram account with engagement metrics
get_mentionsGet posts where your account has been tagged or @mentioned. Useful for tracking UGC.
get_profile_infoGet Instagram business profile information including followers, bio, and account details
get_storiesGet current active stories on your Instagram account. Stories expire after 24 hours.
hide_commentHide or unhide a comment on your Instagram post. Hidden comments are not visible to the public.
post_commentwrite actionPost a top-level comment on an Instagram post. Requires instagram_manage_comments permission.
publish_carouselwrite actionPublish a carousel (album) post with 2-10 images or videos. All media must be publicly accessible URLs.
publish_mediawrite actionUpload and publish an image or video to Instagram with caption and optional location
publish_reelwrite actionPublish a Reel (short-form video) to Instagram. Video must be publicly accessible URL, MP4 format.
reply_to_commentReply to a specific comment on an Instagram post. Requires instagram_manage_comments permission.
search_hashtagSearch for an Instagram hashtag and get its ID. Use the returned ID with get_hashtag_media.
send_dmwrite actionSend Instagram direct message. Requires instagram_manage_messages with Advanced Access. Can only reply within 24 hours.
validate_access_tokenValidate the Instagram API access token and check permissions
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 15 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Instagram compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 23
- the typical server has 7
- Tools that change things
- 26%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 42
- more than 93% of 28,688 servers
- Downloads a week
- 139
- more than 70% of 12,191 servers with a package
What its tools let an agent do: 16 read · 1 delete · 6 send or post
Install Instagram in Claude Code, Cursor or VS Code
Runs npx -y @mcpware/instagram-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add instagram-mcp -- npx -y @mcpware/instagram-mcp
What the publisher says
From the Instagram repository's README, as published. We do not edit it. Read it on GitHub
@mcpware/instagram-mcp
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
- Instagram Business Account: Must be connected to a Facebook Page
- Facebook Developer Account: Required for API access
- Access Token: Long-lived access token with appropriate permissions
- Python 3.10+: For running the MCP server (required by MCP dependencies)
Required Instagram API Permissions
Standard Access (available immediately):
- instagram_basic
- instagramcontentpublish
- instagrammanageinsights
- instagrammanagecomments
- pagesshowlist
- pagesreadengagement
- pagesmanagemetadata
- pagesreaduser_content
- business_management
Advanced Access (requires Meta App Review):
- instagrammanagemessages - Required for Direct Messaging features
⚠️ Instagram DM Features: Reading and sending Instagram direct messages requires Advanced Access approval from Meta. See INSTAGRAMDMSETUP.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
- Convert to Business Account (if not already):
- Open Instagram app → Settings → Account → Switch to Professional Account
- Choose "Business" → Select a category → Complete setup
- 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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Instagram: common questions
- Is Instagram MCP server safe?
- Mostly: it is graded B (82/100). Read the Instagram safety report
- How do I install Instagram?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Instagram need an API key?
- Yes. The registry entry asks for
INSTAGRAM_ACCESS_TOKEN. - Is Instagram maintained?
- The last commit was 52 days ago (2026-09-13). The latest release is v1.0.4.
- How does Instagram compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 23 (the typical server has 7); tools that change things 26% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.