# Threads for Claude

> Remote MCP server (streamable HTTP, OAuth 2.1) that gives an AI agent access to one user's Threads (threads.com) account: publishing, replies and moderation, search and insights.

MCP endpoint: https://threads-mcp.app/mcp

## When to use this

Use Threads for Claude when the user wants to act on **their own Threads account** from a chat:

- Publish to Threads: a single text/image/video post, a carousel of 2–20 items, or a multi-part thread from long-form text.
- Manage conversations: read replies and mentions, reply, hide spam replies, repost, delete their posts.
- Report on performance: views, likes, replies, reposts, quotes and shares per post or for a date range ("what performed best this month?"), and account-level metrics and follower demographics.
- Research: search public Threads posts by keyword or topic tag, look up public profiles and their recent posts.

Do not use it for:

- Instagram, Facebook or X/Twitter; it only covers Threads.
- Scheduling posts for later: Threads has no scheduling API, so publish when the user approves.
- Reading likes or views of other people's posts; Threads only exposes metrics for the user's own posts.
- Anonymous or unattended use; every call runs as a signed-in Threads user who connected the account.

## How to call it

1. Add the MCP server: `https://threads-mcp.app/mcp` (transport: streamable HTTP).
   - Claude (web, desktop, mobile): Settings → Connectors → Add custom connector → paste the URL.
   - Claude Code: `claude mcp add --transport http threads https://threads-mcp.app/mcp`, then `/mcp` → Authenticate.
2. Authenticate with OAuth 2.1 + PKCE; the user signs in with Threads in the browser. Details: https://threads-mcp.app/auth.md
3. Before any tool marked "writes" below, show the user the exact text and get explicit confirmation: these act publicly.
4. For reports, prefer `threads_get_posts_insights` (one call for a whole period) over calling `threads_get_post_insights` per post. Hosts that support MCP Apps render its result as an interactive table.

## Tools

- `threads_list_accounts`: Lists the Threads accounts linked to this connector and which one this app currently acts as. Posts, replies and insights always use the account marked acting.
- `threads_use_account` (writes): Makes this app act as another linked Threads account from now on (other apps keep theirs). Only switch when the user asks for it, and name the account you switched to.
- `threads_get_profile`: Returns the connected Threads account: username, name, bio, profile picture, verification.
- `threads_list_posts`: Lists the connected account's own posts, newest first. Use `after` from the previous response to paginate.
- `threads_get_post`: Returns one post by its media id.
- `threads_create_post` (writes): Publishes a post on the user's Threads account: text (≤ 500 chars, ≤ 5 links), optionally with one image or video, or quoting another post. Publishes publicly and immediately — show the user the final text and get confirmation first. For longer text use threads_create_thread; for several images use threads_create_carousel.
- `threads_create_carousel` (writes): Publishes a carousel of 2–20 images and/or videos with optional text. Publishes publicly — confirm with the user first.
- `threads_create_thread` (writes): Publishes a chain of 2–10 text posts where each post replies to the previous one (for text longer than 500 chars). Each part must be ≤ 500 chars. Publishes publicly — confirm with the user first.
- `threads_reply` (writes): Publishes a reply (text and optional media) to any post or reply by id. Publishes publicly — confirm with the user first.
- `threads_repost` (writes): Reposts an existing post to the user's profile.
- `threads_publish_container` (writes): Checks a media container returned with status 'processing' and publishes it once ready.
- `threads_delete_post` (writes): Permanently deletes one of the user's own posts or replies. Cannot be undone — confirm with the user first.
- `threads_get_replies`: Returns replies to a post. mode 'replies' = top-level replies only; 'conversation' = all nested replies flattened.
- `threads_hide_reply` (writes): Hides (or unhides) a top-level reply on one of the user's posts. Nested replies under it are hidden too.
- `threads_get_mentions`: Lists public posts where the user was @mentioned.
- `threads_get_activity` (writes): Replies to the user's posts and @mentions that Threads pushed since the user last checked (last 30 days), newest first. Use it for 'what's new on Threads?'. By default returns only unseen items and marks them as seen. To answer or hide an item, use threads_reply or threads_hide_reply with its media_id after the user confirms.
- `threads_keyword_search`: Searches public Threads posts by keyword or topic tag. Returns text, author, date, link and whether a post has replies — Threads does not expose likes/views of other people's posts. Until the app is approved for keyword search, results only include the user's own posts. Limit: 2,200 searches per 24 h (empty results don't count).
- `threads_profile_lookup`: Returns a public Threads profile by exact username: name, bio, verification, followers and totals of likes, replies, quotes, reposts and views over the last 7 days. Only public profiles with 100+ followers are returned. Until the app is approved for profile discovery, only official Meta accounts (@meta, @threads, @instagram, @facebook) can be looked up. Limit: 1,000 lookups per 24 h.
- `threads_get_profile_posts`: Lists recent public posts of another Threads profile by exact username (text, type, date, link, whether it has replies, quoted/reposted post). Threads does not expose likes or views of other people's posts. Same access limits as threads_profile_lookup.
- `threads_get_post_insights`: Returns views, likes, replies, reposts, quotes and shares for one post. For many posts or a period use threads_get_posts_insights.
- `threads_get_posts_insights`: Lists the user's own posts published in a date range together with views, likes, replies, reposts, quotes and shares for each, plus totals, average/median views and engagement rate — in one call. Use it for reports and "what performed best" questions instead of calling threads_get_post_insights per post. Dates are YYYY-MM-DD (UTC, inclusive); defaults to the last 30 days. For "all time" pass since=2023-07-05; if the result has a `note` about the limit, call again with `until` set to the oldest date seen to cover older posts.
- `threads_get_account_insights`: Returns account metrics (views, likes, replies, reposts, quotes, clicks, followers_count) for a date range. Dates are YYYY-MM-DD; data is available from 2024-04-13. follower_demographics needs ≥ 100 followers and a breakdown.
- `threads_get_publishing_limit`: Shows how many posts and replies the account has used in the last 24 hours and the limits (250 posts / 1000 replies).

## Discovery

- [MCP manifest](https://threads-mcp.app/.well-known/mcp.json)
- [Agent view of the homepage](https://threads-mcp.app/?mode=agent)
- [MCP server card](https://threads-mcp.app/.well-known/mcp/server-card.json): tools, resources and auth in one JSON document
- [OAuth protected resource metadata](https://threads-mcp.app/.well-known/oauth-protected-resource/mcp)
- [Authentication guide](https://threads-mcp.app/auth.md)
- [OAuth authorization server metadata](https://threads-mcp.app/.well-known/oauth-authorization-server)
- [Agent Skills index](https://threads-mcp.app/.well-known/agent-skills/index.json)
- [OpenAPI spec](https://threads-mcp.app/openapi.json): the public HTTP surface (MCP endpoint and discovery documents)
- [Agentic Resource Discovery catalog](https://threads-mcp.app/.well-known/ard.json) (also at /.well-known/ai-catalog.json)
- [API catalog (RFC 9727)](https://threads-mcp.app/.well-known/api-catalog)
- [Official MCP Registry entry](https://registry.modelcontextprotocol.io/v0/servers?search=app.threads-mcp/threads): `app.threads-mcp/threads`

## Pages

- [Home](https://threads-mcp.app/): setup instructions
- [Developers](https://threads-mcp.app/developers): quickstart, auth, tools, limits
- [Your connection](https://threads-mcp.app/account): see, switch or disconnect the connected Threads account
- [Privacy policy](https://threads-mcp.app/privacy)
- [Terms](https://threads-mcp.app/terms)