Skip to main content
Glama
deenesjakoruzh
exileum

meta-mcp

by exileum
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

meta-mcp

npm version License: MIT meta-mcp MCP server

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)

Related MCP server: Instagram MCP Server

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

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

Account Requirements

Platform

Account Type

Notes

Instagram

Business or Creator

Personal accounts cannot use the Graph API. Free to switch in settings

Threads

Any account

Instagram link no longer required since Sep 2025

Meta (token/webhook)

Meta Developer App

Create at developers.facebook.com

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)

Tool

Description

meta_exchange_token

Exchange short-lived token for long-lived token (~60 days). Requires platform (instagram or threads)

meta_refresh_token

Refresh a long-lived token before expiration. Requires platform (instagram or threads)

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 (supports alt_text)

ig_publish_video

Publish a video post

ig_publish_carousel

Publish a carousel/album (2-10 items, supports alt_text per item)

ig_publish_reel

Publish a Reel (supports alt_text)

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 (requires Facebook Login)

ig_get_media_insights

Get media analytics (views, reach, saved, shares)

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

Tool

Description

ig_get_profile

Get account profile info

ig_get_account_insights

Get account-level analytics (views, reach, follower_count)

ig_business_discovery

Look up another business account

ig_get_collaboration_invites

Get pending collaboration invites

ig_respond_collaboration_invite

Accept or decline collaboration invites

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

Tool

Description

threads_publish_text

Publish a text post in a single API call (auto_publish_text=true, default; set auto_publish=false for the legacy two-step flow). Supports polls, GIFs, link attachments, topic tags, quote posts, spoiler flag, cross-share to IG Stories, text attachments up to 10K chars with styling

threads_publish_image

Publish an image post (supports alt_text, topic tags, spoiler flag, cross-share to IG Stories)

threads_publish_video

Publish a video post (supports alt_text, topic tags, spoiler flag, cross-share to IG Stories)

threads_publish_carousel

Publish a carousel (2-20 items, supports alt_text per item, cross-share to IG Stories)

threads_delete_post

Delete a post (max 100/day)

threads_get_container_status

Check container processing status (unpublished containers only)

threads_get_publishing_limit

Check remaining publishing quota (250 posts/day)

threads_repost

Repost an existing thread to your profile (requires threads_content_publish)

Threads — Media & Search (3)

Tool

Description

threads_get_posts

List published posts (includes topic_tag, poll, GIF fields)

threads_get_post

Get post details

threads_search_posts

Search public posts by keyword or tag (requires threads_keyword_search permission)

Threads — Replies (4)

Tool

Description

threads_get_replies

Get replies to a post (mode='top_level' default, or mode='full_tree' for the entire conversation flattened)

threads_reply

Reply to a post (supports image/video attachments)

threads_hide_reply

Hide a reply

threads_unhide_reply

Unhide a reply

Threads — Mentions (1)

Tool

Description

threads_get_mentions

List posts where the user was @mentioned (requires threads_manage_mentions)

Threads — Profile (2)

Tool

Description

threads_get_profile

Get Threads profile info (includes is_verified)

threads_get_user_threads

List user's threads

Threads — Insights (2)

Tool

Description

threads_get_post_insights

Get post analytics (views, likes, replies, reposts, quotes)

threads_get_user_insights

Get account-level analytics (period: day/lifetime; since/until required for day)

Resources

Resource URI

Description

instagram://profile

Instagram account profile data

threads://profile

Threads account profile data (includes is_verified)

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

  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

meta-mcp MCP server

License

MIT

See CHANGELOG.md for release history.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
32dResponse time
3dRelease cycle
16Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Instagram

    Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.

  • ProductClank

    Boost posts and launch community growth campaigns from your AI assistant. OAuth, credit-billed.

  • socialclaw

    Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/exileum/meta-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server