About Meta Threads MCP
Meta Threads MCP is an MCP server published by MetaThreads in the Developer Tools category: unofficial MCP server for Meta's Threads API.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/MetaThreads/meta-threads-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
threads_create_image_postCreate post with image
Parameters not published.
threads_create_postCreate and publish a text post
Parameters not published.
threads_create_video_postCreate post with video
Parameters not published.
threads_delete_postDelete a post
Parameters not published.
threads_get_postGet a post by ID
Parameters not published.
threads_get_publishing_limitCheck remaining quota
Parameters not published.
threads_get_user_postsGet user's recent posts
Parameters not published.
Ask AI
Ask AI about Meta Threads MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
3 checks have not been run yet.
Releases
README
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
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:
- 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 |
|---|---|---|
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 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 --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.
Related Projects
- meta-threads-sdk - Python SDK for Meta's Threads API
- FastMCP - Simple MCP server framework
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.