meta-mcp

Enables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API.

Prerequisites

• Node.js 22+ (LTS recommended)

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 (8)

Threads — Media & Search (3)

Threads — Replies (4)

Threads — Mentions (1)

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.
No Facebook Page linking required — this uses the Instagram API with Instagram Login.

1. In your Meta App, go to "Instagram" -> "API setup with Instagram business login"
2. In the "Generate access tokens" section, click "Add account" -> log in to your Instagram account
3. The generated token is long-lived (~60 days) — no exchange step needed. Copy it as your INSTAGRAM_ACCESS_TOKEN.
   • To refresh before expiry, use the meta_refresh_token tool with platform: "instagram", or:

     GET https://graph.instagram.com/refresh_access_token
       ?grant_type=ig_refresh_token
       &access_token=LONG_LIVED_TOKEN
     

4. Get your Instagram User ID:

   GET https://graph.instagram.com/v25.0/me?fields=user_id,username&access_token=YOUR_TOKEN
   

   The user_id is your INSTAGRAM_USER_ID.
5. Permissions are configured in your app's Instagram settings. Available scopes:
   • instagram_business_basic — required for all operations
   • instagram_business_content_publish — publishing photos, reels, carousels
   • instagram_business_manage_comments — reading and managing comments
   • instagram_business_manage_messages — DM conversations and messaging

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,threads_share_to_instagram,threads_manage_mentions
     &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 (token must be at least 24h old):

• Instagram: Use meta_refresh_token with platform: "instagram", or call:

  GET https://graph.instagram.com/refresh_access_token
    ?grant_type=ig_refresh_token
    &access_token=CURRENT_LONG_LIVED_TOKEN
  

• Threads: Use meta_refresh_token with platform: "threads", 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.

Glama

License

MIT

See CHANGELOG.md for release history.