English | 한국어

meta-mcp

Full-coverage MCP server for Instagram Graph API (v25.0), Threads API, and Meta platform management.

When to Use

Tell your AI assistant things like:

• "Post a photo to Instagram" — publish photos, videos, reels, stories, and carousels
• "Publish a text post on Threads" — text posts with polls, GIFs, link attachments, and topic tags
• "Get my Instagram follower count and insights" — account and post-level analytics
• "Schedule a carousel post" — multi-image albums on Instagram (2-10) or Threads (2-20)
• "Reply to comments on my latest post" — read and respond to comments on both platforms
• "Cross-post to Instagram and Threads" — use the built-in content_publish prompt
• "Get analytics for my Threads account" — views, likes, replies, reposts, quotes, clicks
• "Manage Instagram DMs" — list conversations, read messages, send replies

AI Agent Integration: See llms.txt for a machine-readable summary, or copy templates/CLAUDE.md / templates/AGENTS.md into your project for automatic MCP discovery.

Features

• 57 tools across Instagram (33), Threads (18), and Meta platform (6)
• Instagram: Publish photos/videos/reels/stories/carousels with alt text, manage comments, view insights, search hashtags, handle DMs, manage collaboration invites
• Threads: Publish text/images/videos/carousels with polls, GIFs, topic tags, link attachments, alt text, spoiler flags; manage replies; search posts; view insights; delete posts
• Meta: Token exchange/refresh/debug, webhook management
• 2 resources: Instagram profile, Threads profile
• 2 prompts: Cross-platform content publishing, analytics report
• Rate limit tracking via x-app-usage header

What's New in v2.0.0

• Graph API v25.0: Upgraded from v21.0 (expired Sep 2025) to v25.0 (current)
• Fixed deprecated metrics: impressions, video_views, engagement replaced with views, reach, saved, shares
• Threads polls: Create posts with interactive poll attachments
• Threads GIFs: Attach GIFs from GIPHY or Tenor
• Threads topic tags: Categorize posts with topic tags
• Threads link attachments: Attach URL preview cards to text posts
• Threads post search: Search public posts by keyword or topic tag
• Threads post deletion: Delete posts (rate limited to 100/day)
• Threads publishing limit: Check remaining quota
• Threads quote posts: Quote other posts by ID
• Threads spoiler flag: Mark content as spoiler
• Threads alt text: Add accessibility descriptions to all media types
• Threads new reply controls: parent_post_author_only and followers_only options
• Instagram alt text: Support for photo, reel, and carousel items
• Instagram collaboration invites: Query and respond to collab invites
• Updated insights metrics: New clicks, reposts, reels_skip_rate metrics

Account Requirements

Installation

npx (Recommended)

{
  "mcpServers": {
    "meta": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/meta-mcp"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_ig_token",
        "INSTAGRAM_USER_ID": "your_ig_user_id",
        "THREADS_ACCESS_TOKEN": "your_threads_token",
        "THREADS_USER_ID": "your_threads_user_id"
      }
    }
  }
}

Manual

git clone https://github.com/mikusnuz/meta-mcp.git
cd meta-mcp
npm install
npm run build

{
  "mcpServers": {
    "meta": {
      "command": "node",
      "args": ["/path/to/meta-mcp/dist/index.js"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_ig_token",
        "INSTAGRAM_USER_ID": "your_ig_user_id",
        "THREADS_ACCESS_TOKEN": "your_threads_token",
        "THREADS_USER_ID": "your_threads_user_id"
      }
    }
  }
}

Environment Variables

You only need to set the variables for the platforms you use. For example, if you only use Threads, just set THREADS_ACCESS_TOKEN and THREADS_USER_ID.

Tools

Meta Platform (6)

Instagram — Publishing (6)

Instagram — Media (5)

Instagram — Comments (7)

Instagram — Profile & Insights (5)

Instagram — Hashtags (4)

Instagram — Mentions & Tags (2)

Instagram — Messaging (4)

Threads — Publishing (7)

Threads — Media & Search (3)

Threads — Replies (4)

Threads — Profile (2)

Threads — Insights (2)

Resources

Prompts

Setup Guide

Step 1: Create a Meta Developer App

All platforms (Instagram, Threads) require a Meta Developer App.

1. Go to developers.facebook.com and log in
2. Click "My Apps" → "Create App"
3. Select "Other" → "Business" (or "None" for personal use)
4. Enter an app name and create

Your META_APP_ID and META_APP_SECRET are in App Settings → Basic.

Step 2: Instagram Setup

Requires an Instagram Business or Creator account. Switch for free in Instagram app → Settings → Account type.

1. In your Meta App, go to "Add Products" → add "Instagram Graph API"
2. Go to "Instagram Graph API" → "Settings" and connect your Instagram Business account via a Facebook Page
3. Open the Graph API Explorer
   • Select your app
   • Add permissions: instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights, instagram_manage_contents, pages_show_list, pages_read_engagement
   • Click "Generate Access Token" and authorize
4. The generated token is short-lived (~1 hour). Exchange it for a long-lived token (~60 days):
   hljs language-ini

   Copy

   GET https://graph.facebook.com/v25.0/oauth/access_token
     ?grant_type=fb_exchange_token
     &client_id=YOUR_APP_ID
     &client_secret=YOUR_APP_SECRET
     &fb_exchange_token=SHORT_LIVED_TOKEN
   

   Or use the meta_exchange_token tool after setup.
5. Get your Instagram User ID — call this with your token:
   hljs language-bash

   Copy

   GET https://graph.facebook.com/v25.0/me/accounts?access_token=YOUR_TOKEN
   

   This returns your Facebook Pages. For each page, get the linked Instagram account:
   hljs language-css

   Copy

   GET https://graph.facebook.com/v25.0/{page-id}?fields=instagram_business_account&access_token=YOUR_TOKEN
   

   The instagram_business_account.id is your INSTAGRAM_USER_ID (a numeric ID like 17841400123456789).

Step 3: Threads Setup

Works with any Threads account (personal or business). Instagram account link is no longer required since September 2025.

1. In your Meta App, go to "Add Products" → add "Threads API"
2. Go to "Threads API" → "Settings":
   • Add your Threads account as a Threads Tester under "Roles"
   • Accept the invitation in the Threads app: Settings → Account → Website permissions → Invites
3. Generate an authorization URL:
   hljs language-ini

   Copy

   https://threads.net/oauth/authorize
     ?client_id=YOUR_APP_ID
     &redirect_uri=YOUR_REDIRECT_URI
     &scope=threads_basic,threads_content_publish,threads_manage_insights,threads_manage_replies,threads_read_replies
     &response_type=code
   

   • For local testing, use https://localhost/ as redirect URI (configure in App Settings → Threads API → Redirect URIs)
4. After authorization, exchange the code for an access token:
   hljs language-ini

   Copy

   POST https://graph.threads.net/oauth/access_token
   Content-Type: application/x-www-form-urlencoded
   
   client_id=YOUR_APP_ID
   &client_secret=YOUR_APP_SECRET
   &grant_type=authorization_code
   &redirect_uri=YOUR_REDIRECT_URI
   &code=AUTHORIZATION_CODE
   

5. Exchange for a long-lived token (~60 days):
   hljs language-ini

   Copy

   GET https://graph.threads.net/access_token
     ?grant_type=th_exchange_token
     &client_secret=YOUR_APP_SECRET
     &access_token=SHORT_LIVED_TOKEN
   

6. Get your Threads User ID — call this with your token:
   hljs language-bash

   Copy

   GET https://graph.threads.net/v1.0/me?fields=id,username&access_token=YOUR_TOKEN
   

   The id field is your THREADS_USER_ID (a numeric ID like 1234567890).

Step 4: Configure Environment Variables

Set only the variables for the platforms you use:

# Instagram (requires Business/Creator account)
INSTAGRAM_ACCESS_TOKEN=EAAxxxxxxx...     # Long-lived token from Step 2
INSTAGRAM_USER_ID=17841400123456789      # Numeric ID from Step 2.5

# Threads (any account)
THREADS_ACCESS_TOKEN=THQWxxxxxxx...      # Long-lived token from Step 3
THREADS_USER_ID=1234567890               # Numeric ID from Step 3.6

# Meta App (for token management & webhooks)
META_APP_ID=123456789012345              # From App Settings → Basic
META_APP_SECRET=abcdef0123456789abcdef   # From App Settings → Basic

Token Renewal

Access tokens expire after ~60 days. Refresh before expiration:

• Instagram: Use meta_exchange_token with the current valid token
• Threads: Use meta_refresh_token or call:
  hljs language-ini

  Copy

  GET https://graph.threads.net/refresh_access_token
    ?grant_type=th_refresh_token
    &access_token=CURRENT_LONG_LIVED_TOKEN
  

You can check token status anytime with meta_debug_token.

Deprecated Metrics (v22.0+)

The following Instagram metrics were deprecated in Graph API v22.0 (January 2025) and removed for all versions on April 21, 2025:

License

MIT