Skip to main content
Glama
meta-threads-mcp

meta-threads-mcp

by MetaThreads

meta-threads-mcp

Unofficial MCP server for Meta's Threads API. Enables LLMs like Claude to publish posts, manage replies, and track insights through the Model Context Protocol.

PyPI version Python 3.12+ License: MIT

Features

  • Full Threads API coverage via MCP tools

  • Create text, image, and video posts

  • Reply management (reply, hide/unhide, get conversation)

  • Post and user insights/metrics

  • Publishing quota tracking

  • Built on meta-threads-sdk and FastMCP

Related MCP server: threads-mcp

Installation

pip install meta-threads-mcp

Or with uv:

uv add meta-threads-mcp

Running on FastMCP Cloud

The easiest way to run this MCP server is to deploy it on FastMCP Cloud:

  1. Go to fastmcp.cloud and sign in

  2. Connect your GitHub repository

  3. FastMCP Cloud will automatically detect the fastmcp.json configuration and deploy your server

FastMCP Cloud

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "threads": {
      "command": "meta-threads-mcp"
    }
  }
}

Authentication

The server expects a bearer token in the format:

<access_token>:<user_id>

The client passes this token via the request context when calling tools.

Available Tools

Posts

Tool

Description

Parameters

threads_create_post

Create and publish a text post

text (required), reply_control (optional)

threads_create_image_post

Create post with image

image_url (required), text (optional)

threads_create_video_post

Create post with video

video_url (required), text (optional)

threads_get_post

Get a post by ID

post_id (required)

threads_get_user_posts

Get user's recent posts

limit (optional, default 10)

threads_delete_post

Delete a post

post_id (required)

threads_get_publishing_limit

Check remaining quota

none

Replies

Tool

Description

Parameters

threads_reply_to_post

Reply to a post

post_id (required), text (required)

threads_get_replies

Get replies to a post

post_id (required)

threads_get_conversation

Get full conversation thread

post_id (required)

threads_hide_reply

Hide a reply

reply_id (required)

threads_unhide_reply

Unhide a reply

reply_id (required)

Insights

Tool

Description

Parameters

threads_get_media_insights

Get metrics for a post

media_id (required)

threads_get_user_insights

Get user-level metrics

none

User

Tool

Description

Parameters

threads_get_profile

Get current user's profile

none

Reply Control Options

When creating posts, you can control who can reply:

  • EVERYONE (default) - Anyone can reply

  • ACCOUNTS_YOU_FOLLOW - Only accounts you follow can reply

  • MENTIONED_ONLY - Only mentioned accounts can reply

Rate Limits

  • 250 posts per 24 hours

  • 1000 replies per 24 hours

Use threads_get_publishing_limit to check your current quota.

Development

Setup

git clone https://github.com/MetaThreads/meta-threads-mcp.git
cd meta-threads-mcp
uv sync --dev

Running Tests

uv run pytest

Linting & Type Checking

uv run ruff check src tests
uv run ruff format src tests
uv run mypy src

Testing with FastMCP CLI

fastmcp dev src/meta_threads_mcp/server.py

License

MIT License - see LICENSE for details.

Available Tools

15 tools
threads_create_image_postA

Create and publish a post with an image to Threads.

Args: ctx: FastMCP request context image_url: URL of the image to post text: Optional text content of the post reply_control: Who can reply - EVERYONE, ACCOUNTS_YOU_FOLLOW, or MENTIONED_ONLY

Inputs: image_url (required), text, reply_control. Returns: object

threads_create_postA

Create and publish a text post to Threads.

Args: ctx: FastMCP request context text: The text content of the post reply_control: Who can reply - EVERYONE, ACCOUNTS_YOU_FOLLOW, or MENTIONED_ONLY

Inputs: text (required), reply_control. Returns: object

threads_create_video_postA

Create and publish a post with a video to Threads.

Args: ctx: FastMCP request context video_url: URL of the video to post text: Optional text content of the post reply_control: Who can reply - EVERYONE, ACCOUNTS_YOU_FOLLOW, or MENTIONED_ONLY

Inputs: video_url (required), text, reply_control. Returns: object

threads_delete_postC

Delete a Threads post.

Args: ctx: FastMCP request context post_id: The ID of the post to delete

Inputs: post_id (required). Returns: object

threads_get_conversationB

Get the full conversation thread for a post.

Args: ctx: FastMCP request context post_id: The ID of the post to get the conversation for

Inputs: post_id (required). Returns: object

threads_get_media_insightsB

Get metrics/insights for a specific post.

Args: ctx: FastMCP request context media_id: The ID of the media/post to get insights for

Inputs: media_id (required). Returns: object

threads_get_postB

Get a Threads post by ID.

Args: ctx: FastMCP request context post_id: The ID of the post to retrieve

Inputs: post_id (required). Returns: object

threads_get_profileB

Get the authenticated user's profile.

Args: ctx: FastMCP request context

Inputs: no named parameters. Returns: object

threads_get_publishing_limitA

Check remaining publishing quota (250 posts/day, 1000 replies/day).

Args: ctx: FastMCP request context

Inputs: no named parameters. Returns: object

threads_get_repliesB

Get replies to a Threads post.

Args: ctx: FastMCP request context post_id: The ID of the post to get replies for

Inputs: post_id (required). Returns: object

threads_get_user_insightsA

Get user-level metrics/insights for the authenticated user.

Args: ctx: FastMCP request context

Inputs: no named parameters. Returns: object

threads_get_user_postsB

Get the authenticated user's recent posts.

Args: ctx: FastMCP request context limit: Maximum number of posts to return (default 10)

Inputs: limit. Returns: object

threads_hide_replyB

Hide a reply to your post.

Args: ctx: FastMCP request context reply_id: The ID of the reply to hide

Inputs: reply_id (required). Returns: object

threads_reply_to_postA

Reply to an existing Threads post.

Args: ctx: FastMCP request context post_id: The ID of the post to reply to text: The text content of the reply

Inputs: text (required), post_id (required). Returns: object

threads_unhide_replyA

Unhide a previously hidden reply.

Args: ctx: FastMCP request context reply_id: The ID of the reply to unhide

Inputs: reply_id (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action; even the three creation variants are clearly separated by media type. The only subtle overlap is between get_replies and get_conversation, but their descriptions differentiate direct replies from a full threaded view.

    Naming Consistency5/5

    All tools follow a consistent pattern: prefixed with `threads_` followed by a verb and noun (e.g., create_post, get_replies, hide_reply). No mixed naming conventions, making the set predictable.

    Tool Count5/5

    15 tools is appropriately scoped for a social media API server, covering content creation, retrieval, deletion, replies, moderation, and analytics without feeling bloated.

    Completeness4/5

    Core content lifecycle (create/get/delete/reply) is covered along with moderation (hide/unhide) and analytics for both media and user. Some gaps exist such as searching posts or accessing other users' profiles, but these are beyond the typical API scope, so overall this is a solid surface.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      MCP server for the Threads API, enabling profile management, content reading, publishing, replies, and discovery through 26 tools.
      26
      -
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server for Meta's Threads that acts as your own account, enabling reading profiles, posts, replies, timeline, search, and performing actions like posting, replying, liking, following, and scheduling, using a real logged-in browser session.
      24
      22 npm
      3
      MIT