meta-mcp

MCP server for Instagram Graph API (v25.0), Threads API, and Meta platform management. Publish content, manage comments, view insights, and handle DMs — all through AI assistants.

Quick Start

Add to your MCP client config:

{
  "mcpServers": {
    "meta": {
      "command": "npx",
      "args": ["-y", "@exileum/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"
      }
    }
  }
}

Only set the variables for the platforms you use.

Manual Installation

git clone https://github.com/exileum/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

Account Requirements

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; delete posts; view insights

• 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

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

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):

   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:

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

   For each page, get the linked Instagram account:

   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.

Step 3: Threads Setup

Works with any Threads account. Instagram link no longer required since Sep 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:

   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:

   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):

   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:

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

   The id field is your THREADS_USER_ID.

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:

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

Check token status anytime with meta_debug_token.

Deprecated Metrics (Graph API v22.0+)

License

MIT

See CHANGELOG.md for release history.