Log inSubmit server
Meta MCP logo

Meta MCP

by mikusnuz

Connects Instagram, Threads, and Meta APIs to MCP for publishing, moderation, analytics, messaging, and token management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Meta MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mikusnuz-meta-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-mcp"
      ],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "INSTAGRAM_USER_ID": "YOUR_VALUE_HERE",
        "INSTAGRAM_MESSAGING_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "INSTAGRAM_PAGE_ID": "YOUR_VALUE_HERE",
        "THREADS_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "THREADS_USER_ID": "YOUR_VALUE_HERE",
        "META_APP_ID": "YOUR_VALUE_HERE",
        "META_APP_SECRET": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

mikusnuz/meta-mcp MCP server exposes tools for the Instagram Graph API, Threads API, and Meta app management over MCP. It supports publishing media, handling comments, reading insights, managing Instagram messaging, searching hashtags, and working with access tokens and webhooks. Configure only the credentials for the platform features you use, then run it through an MCP client with npx or a built Node.js entry point. Reach for it when an agent needs to operate professional Instagram or Threads accounts through Meta’s APIs.

Use cases

  • Publish Instagram media from an AI workflow
  • Moderate comments and replies on Instagram posts
  • Collect Instagram and Threads account insights
  • Manage Meta access tokens and webhook subscriptions
  • Cross-post content between Instagram and Threads

Key features

  • Instagram photo, video, Reel, Story, and carousel publishing
  • Instagram comments, insights, profiles, and hashtag search
  • Threads publishing, replies, discovery, and analytics
  • Meta token exchange, refresh, debugging, and webhooks
  • Instagram messaging and collaboration-invite support
  • MCP resources and prompts for profiles and content workflows

Tools66

What Meta MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/19 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @mikusnuz/meta-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars30Stargazers on the source repository.
npm downloads1.9kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Tools exposed66Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Meta MCP works

What mikusnuz/meta-mcp MCP server does

mikusnuz/meta-mcp MCP server connects MCP-compatible agents to the Instagram Graph API, Threads API, and selected Meta platform management endpoints. Its Instagram coverage includes publishing photos, videos, Reels, Stories, and carousels; reading and moderating comments; retrieving account and media insights; looking up public business or creator profiles; and searching hashtags.

For Threads, the repository documents text and media publishing, carousels, polls, GIFs, topic tags, link attachments, alt text, spoiler flags, ghost posts, reply controls, location tags, and cross-sharing to Instagram Stories. It also describes Threads reply management, public-post search, profile discovery, mentions, oEmbed, conversations, post deletion, and analytics. Meta platform tools handle token exchange, token refresh, token inspection, app information, and webhook subscriptions.

How it works

The package runs as a Node.js MCP process and sends API requests using credentials supplied through environment variables. Publishing Instagram media uses the platform’s container workflow; video-based operations wait for processing before publication. Carousel publishing accepts between two and ten media items.

Requests that use Instagram require a Business or Creator account rather than a personal account. Threads access is available to any Threads account according to the repository requirements. Meta token and webhook operations require a Meta Developer App.

Setup and configuration

mikusnuz/meta-mcp MCP server requires Node.js 20 or later. The recommended setup runs npx -y @mikusnuz/meta-mcp from the MCP client configuration. Alternatively, clone the repository, run npm install, build it with npm run build, and start dist/index.js with Node.

Set only the variables needed for the APIs you plan to use:

  • INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_USER_ID for Instagram operations.
  • INSTAGRAM_MESSAGING_ACCESS_TOKEN and INSTAGRAM_PAGE_ID for Instagram DMs.
  • THREADS_ACCESS_TOKEN and THREADS_USER_ID for Threads operations.
  • META_APP_ID and META_APP_SECRET for token and webhook tools.

The Instagram publishing tools require publicly accessible HTTPS media URLs where specified. Token exchange and webhook subscription operations require the Meta app credentials.

Tools and capabilities

The documented capability areas include:

  • Publish Instagram photos, videos, Reels, Stories, and carousels.
  • Retrieve media, profiles, comments, replies, account insights, and media insights.
  • Post, reply to, hide, unhide, or delete Instagram comments; deletion is irreversible.
  • Search Instagram hashtags and manage collaboration invites.
  • Publish and analyze Threads content, including polls, GIFs, links, topics, quotes, and media.
  • Inspect, refresh, and exchange tokens, and manage Meta webhook subscriptions.

Limitations and notes

Instagram API access is restricted by account type and required permissions. Hashtag search is limited to 30 unique hashtags in a rolling seven-day period. Deleting media or comments cannot be undone. Long-lived token exchange produces a token valid for approximately 60 days, so applications should plan for refresh and inspection flows.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Meta MCP

mikusnuz/meta-mcp is an MCP server that connects AI agents to the Instagram Graph API, Threads API, and Meta platform tools. Its main capabilities include publishing media, managing comments and replies, reading insights, handling Instagram messaging, searching hashtags, and exchanging, refreshing, or inspecting access tokens.

Install it with `npx -y @mikusnuz/meta-mcp` in your MCP client configuration. You can also clone the repository, run `npm install`, build with `npm run build`, and launch `dist/index.js` using Node.js 20 or later.

Set the variables for the platform features you use. Instagram uses `INSTAGRAM_ACCESS_TOKEN` and `INSTAGRAM_USER_ID`; messaging additionally uses `INSTAGRAM_MESSAGING_ACCESS_TOKEN` and `INSTAGRAM_PAGE_ID`; Threads uses `THREADS_ACCESS_TOKEN` and `THREADS_USER_ID`; Meta token and webhook tools use `META_APP_ID` and `META_APP_SECRET`.

Yes, it can publish Instagram carousels containing two to ten images or videos. Each carousel item needs an image URL or video URL, and the media must meet the API requirements, including publicly accessible HTTPS URLs where required.

No, the Instagram Graph API requires a Business or Creator account. Personal Instagram accounts cannot use these Graph API operations, while the repository states that Threads supports any account type.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMeta MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mikusnuz-meta-mcp?style=directory)](https://allmcps.com/mcp/mikusnuz-meta-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/mikusnuz-meta-mcp"><img src="https://allmcps.com/api/badge/mikusnuz-meta-mcp?style=directory" alt="Meta MCP on AllMCPs" /></a>