Skip to main content
Glama
MetaThreads

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: meta-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.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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/MetaThreads/meta-threads-mcp'

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