English | 한국어

meta-mcp

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

Features

• 52 tools across Instagram (31), Threads (15), and Meta platform (6)
• Instagram: Publish photos/videos/reels/stories/carousels, manage comments, view insights, search hashtags, handle DMs
• Threads: Publish text/images/videos/carousels, manage replies, 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

Account Requirements

| Platform | Account Type | Notes | |----------|-------------|-------| | Instagram | Business or Creator account | Personal accounts cannot use the Graph API. Free to switch in Instagram settings | | Threads | Any account | All Threads accounts can use the API | | Meta (token/webhook tools) | Meta Developer App | Create at developers.facebook.com |

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

| Variable | Required | Description | |----------|----------|-------------| | INSTAGRAM_ACCESS_TOKEN | For Instagram | Instagram Graph API access token | | INSTAGRAM_USER_ID | For Instagram | Instagram Business/Creator account ID | | THREADS_ACCESS_TOKEN | For Threads | Threads API access token | | THREADS_USER_ID | For Threads | Threads user ID | | META_APP_ID | For token/webhook tools | Meta App ID | | META_APP_SECRET | For token/webhook tools | Meta App Secret |

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)

| Tool | Description | |------|-------------| | meta_exchange_token | Exchange short-lived token for long-lived token (~60 days) | | meta_refresh_token | Refresh a long-lived token before expiration | | meta_debug_token | Inspect token validity, expiration, and scopes | | meta_get_app_info | Get Meta App information | | meta_subscribe_webhook | Subscribe to webhook notifications | | meta_get_webhook_subscriptions | List current webhook subscriptions |

Instagram — Publishing (6)

| Tool | Description | |------|-------------| | ig_publish_photo | Publish a photo post | | ig_publish_video | Publish a video post | | ig_publish_carousel | Publish a carousel/album (2-10 items) | | ig_publish_reel | Publish a Reel | | ig_publish_story | Publish a Story (24hr) | | ig_get_container_status | Check media container processing status |

Instagram — Media (5)

| Tool | Description | |------|-------------| | ig_get_media_list | List published media | | ig_get_media | Get media details | | ig_delete_media | Delete a media post | | ig_get_media_insights | Get media analytics | | ig_toggle_comments | Enable/disable comments on a post |

Instagram — Comments (7)

| Tool | Description | |------|-------------| | ig_get_comments | Get comments on a post | | ig_get_comment | Get comment details | | ig_post_comment | Post a comment | | ig_get_replies | Get replies to a comment | | ig_reply_to_comment | Reply to a comment | | ig_hide_comment | Hide/unhide a comment | | ig_delete_comment | Delete a comment |

Instagram — Profile & Insights (3)

| Tool | Description | |------|-------------| | ig_get_profile | Get account profile info | | ig_get_account_insights | Get account-level analytics | | ig_business_discovery | Look up another business account |

Instagram — Hashtags (4)

| Tool | Description | |------|-------------| | ig_search_hashtag | Search hashtag by name | | ig_get_hashtag | Get hashtag info | | ig_get_hashtag_recent | Get recent media for a hashtag | | ig_get_hashtag_top | Get top media for a hashtag |

Instagram — Mentions & Tags (2)

| Tool | Description | |------|-------------| | ig_get_mentioned_comments | Get comments mentioning you | | ig_get_tagged_media | Get media you're tagged in |

Instagram — Messaging (4)

| Tool | Description | |------|-------------| | ig_get_conversations | List DM conversations | | ig_get_messages | Get messages in a conversation | | ig_send_message | Send a DM | | ig_get_message | Get message details |

Threads — Publishing (5)

| Tool | Description | |------|-------------| | threads_publish_text | Publish a text post | | threads_publish_image | Publish an image post | | threads_publish_video | Publish a video post | | threads_publish_carousel | Publish a carousel (2-20 items) | | threads_get_container_status | Check container processing status |

Threads — Media (2)

| Tool | Description | |------|-------------| | threads_get_posts | List published posts | | threads_get_post | Get post details |

Threads — Replies (4)

| Tool | Description | |------|-------------| | threads_get_replies | Get replies to a post | | threads_reply | Reply to a post | | threads_hide_reply | Hide a reply | | threads_unhide_reply | Unhide a reply |

Threads — Profile (2)

| Tool | Description | |------|-------------| | threads_get_profile | Get Threads profile info | | threads_get_user_threads | List user's threads |

Threads — Insights (2)

| Tool | Description | |------|-------------| | threads_get_post_insights | Get post analytics | | threads_get_user_insights | Get account-level analytics |

Resources

| Resource URI | Description | |-------------|-------------| | instagram://profile | Instagram account profile data | | threads://profile | Threads account profile data |

Prompts

| Prompt | Description | |--------|-------------| | content_publish | Cross-post content to Instagram and Threads | | analytics_report | Generate combined analytics report |

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, 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/v21.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:

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

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

   GET https://graph.facebook.com/v21.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).

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 — call this with your token:

   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:

  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.

License

MIT