threads-mcp

What is threads-mcp?

threads-mcp is a TypeScript-based Node MCP server that enables an LLM to generate and publish complete social media posts to Threads (Meta’s platform), automatically fetching supporting stock images from Unsplash.

How to use threads-mcp?

Clone the repository, install dependencies, build, and run. Configure your Claude Desktop config file with the required environment variables (Unsplash API key, Threads App ID/Secret, redirect URI, etc.) and restart Claude. The server exposes the post_thread tool; Claude will guide you through the OAuth authorization to obtain a long-lived token.

Key features of threads-mcp

• Posts auto‑generated text and images to Threads
• Fetches royalty‑free stock photos from Unsplash
• Designed for LLM‑driven, ready‑to‑publish content
• Easy integration with Claude Desktop via MCP

Use cases of threads-mcp

• Prompt an LLM like “post a thread about cats with photos” and get a polished, published result
• Automate social media content curation and scheduling for Threads

FAQ from threads-mcp

Do I need a Meta Developer account?

Yes. You must create an app on the Meta Developer platform, enable the Threads API use case, and obtain your App ID, App Secret, and Redirect Callback URL.

What environment variables are required?

You need HOST, APP_ID, APP_SECRET, REDIRECT_URI, INITIAL_USER_ID, UNSPLASH_ACCESS_KEY, and PORT.

How do I authenticate with Threads?

The server requires a long‑lived access token. Claude Desktop will walk you through the OAuth authorization process after the server is configured.

Does the server support images?

Yes. It uses the Unsplash API to retrieve relevant stock photos and includes them in the post.

What tool does threads-mcp expose?

The primary tool is post_thread, which posts a new thread with text and accompanying images.