MCP 服务器

@node2flow/instagram-mcp

MCP server for Instagram Graph API providing 25 tools for publishing photos, reels, carousels, and stories, managing comments, viewing insights, and searching hashtags.

README

@node2flow/instagram-mcp

MCP server for Instagram Graph API — publish photos, reels, carousels, and stories, manage comments, view insights, and search hashtags through 25 tools.

Quick Start

Claude Desktop / Cursor

{
  "mcpServers": {
    "instagram": {
      "command": "npx",
      "args": ["-y", "@node2flow/instagram-mcp"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_access_token",
        "INSTAGRAM_ACCOUNT_ID": "your_ig_business_account_id"
      }
    }
  }
}

Streamable HTTP (for n8n, custom clients)

INSTAGRAM_ACCESS_TOKEN=xxx npx @node2flow/instagram-mcp --http
# Server starts on http://localhost:3000/mcp

Docker

docker compose up -d

Configuration

Variable	Required	Description
`INSTAGRAM_ACCESS_TOKEN`	Yes	Facebook/Instagram User Access Token with instagram_* permissions
`INSTAGRAM_ACCOUNT_ID`	No	Instagram Business Account ID (find via Facebook Page settings)

Getting an Access Token

Go to Meta for Developers > Graph API Explorer
Select your app, request these permissions:
- instagram_basic — Read profile and media
- instagram_content_publish — Publish media
- instagram_manage_comments — Manage comments
- instagram_manage_insights — Read insights
- pages_show_list, pages_read_engagement
Generate a User Access Token and exchange for a long-lived token

Finding Your Instagram Account ID

GET /me/accounts?fields=instagram_business_account

The instagram_business_account.id is your Instagram Account ID.

25 Tools

Category	Tools	Description
Account (3)	`ig_get_account`, `ig_get_account_insights`, `ig_list_media`	Profile info, analytics, media list
Publishing (4)	`ig_publish_photo`, `ig_publish_carousel`, `ig_publish_reel`, `ig_publish_story`	Create posts, reels, carousels, stories
Media (3)	`ig_get_media`, `ig_get_media_insights`, `ig_get_children`	Media details, analytics, carousel items
Comments (5)	`ig_list_comments`, `ig_get_comment`, `ig_reply_comment`, `ig_delete_comment`, `ig_hide_comment`	Comment management + moderation
Stories (2)	`ig_list_stories`, `ig_get_story_insights`	Active stories + analytics
Hashtags (3)	`ig_search_hashtag`, `ig_get_hashtag_recent`, `ig_get_hashtag_top`	Hashtag research + discovery
Mentions (2)	`ig_list_tags`, `ig_get_mentioned_media`	Tagged and mentioned media