meta-threads-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meta-threads-mcp create a text post saying 'Hello from MCP!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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-mcpOr with uv:
uv add meta-threads-mcpRunning on FastMCP Cloud
The easiest way to run this MCP server is to deploy it on FastMCP Cloud:
Go to fastmcp.cloud and sign in
Connect your GitHub repository
FastMCP Cloud will automatically detect the
fastmcp.jsonconfiguration and deploy your server

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 |
| Create and publish a text post |
|
| Create post with image |
|
| Create post with video |
|
| Get a post by ID |
|
| Get user's recent posts |
|
| Delete a post |
|
| Check remaining quota | none |
Replies
Tool | Description | Parameters |
| Reply to a post |
|
| Get replies to a post |
|
| Get full conversation thread |
|
| Hide a reply |
|
| Unhide a reply |
|
Insights
Tool | Description | Parameters |
| Get metrics for a post |
|
| Get user-level metrics | none |
User
Tool | Description | Parameters |
| Get current user's profile | none |
Reply Control Options
When creating posts, you can control who can reply:
EVERYONE(default) - Anyone can replyACCOUNTS_YOU_FOLLOW- Only accounts you follow can replyMENTIONED_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 --devRunning Tests
uv run pytestLinting & Type Checking
uv run ruff check src tests
uv run ruff format src tests
uv run mypy srcTesting with FastMCP CLI
fastmcp dev src/meta_threads_mcp/server.pyLicense
MIT License - see LICENSE for details.
Related Projects
meta-threads-sdk - Python SDK for Meta's Threads API
FastMCP - Simple MCP server framework
Available Tools
15 toolsthreads_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
Scored across 15 tools
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.
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.
15 tools is appropriately scoped for a social media API server, covering content creation, retrieval, deletion, replies, moderation, and analytics without feeling bloated.
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
Related MCP Connectors
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.
Hosted MCP server for AI agents to post to LinkedIn profiles and X and upload to YouTube.
PostHero MCP server — schedule and publish social media posts from any MCP-compatible AI tool
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA stdio MCP server for the official Threads API, enabling publishing, reading, moderation, insights, discovery, locations, and setup diagnostics.2MIT
- FlicenseAqualityDmaintenanceMCP server for the Threads API, enabling profile management, content reading, publishing, replies, and discovery through 26 tools.26-
- AlicenseAqualityCmaintenanceCustom MCP server for Threads (Meta) — post, reply, and read insights via the official free Threads API.5MIT
- AlicenseAqualityCmaintenanceAn 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.2422 npm3MIT