mcp-threads 0.1.0

MCP server wrapping the Threads API into 6 AI-callable tools for social media content management

MCP Threads

繁體中文

An open-source MCP (Model Context Protocol) server that wraps the Threads API into 6 AI-callable tools for social media content management.

Built for Claude Code, Claude Desktop, and any MCP-compatible AI client. Enables AI agents to read profiles, list posts/replies/mentions, check publishing limits, and publish text posts through natural language.

Disclaimer: This project requires a valid Threads account token. It is intended for personal use and internal tooling only.

What This Does

• 6 ready-to-use tools covering profile, posts, replies, mentions, publishing limits, and text posting
• MCP server (stdio JSON-RPC 2.0) — plug into Claude Code and start interacting with Threads immediately
• Minimal dependencies — built on mcp SDK with no external API client libraries
• Local stdio server — works with Claude Desktop, Claude Code, and any MCP-compatible host

Quick Start

Install

pip install mcp-threads

Or use uvx (no install needed):

uvx mcp-threads serve

Set your token:

export THREADS_TOKEN="<your-token>"

Use with Claude Code

Add the server via the Claude CLI:

claude mcp add --transport stdio threads -- mcp-threads serve

Or with the environment variable inline:

claude mcp add --transport stdio threads -e THREADS_TOKEN=your_token_here -- mcp-threads serve

If you clone the repo locally, the .mcp.json config will be auto-detected by Claude Code and all 6 tools become available immediately.

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "threads": {
      "command": "mcp-threads",
      "args": ["serve"],
      "env": {
        "THREADS_TOKEN": "your_token_here"
      }
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "threads": {
      "command": "uvx",
      "args": ["mcp-threads", "serve"],
      "env": {
        "THREADS_TOKEN": "your_token_here"
      }
    }
  }
}

Tools (6)

Tool	Description
threads_profile_me	Read the authenticated Threads user profile
threads_posts_list	List posts created by the authenticated user
threads_publishing_limit	Read publishing quota usage and config
threads_mentions_list	List public Threads posts that mention the authenticated user
threads_replies_list	List replies created by the authenticated user
threads_post_text	Create and publish a text post or reply

License

MIT