Bluesky MCP Server

What is Bluesky MCP Server?

A Model Context Protocol (MCP) server that connects to Bluesky and provides tools to interact with the ATProtocol. It is intended for LLM-based applications like Claude Desktop to act as a natural language Bluesky client.

How to use Bluesky MCP Server?

Install via Smithery (npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude) or manually by cloning the repo, running pnpm install and pnpm run build. Configure the server with environment variables BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD, and BLUESKY_SERVICE_URL. Then add the server to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json).

Key features of Bluesky MCP Server

• Interact with Bluesky features via natural language commands
• Fetch and analyze feeds, timeline, lists, and user posts
• Search for posts, people, and feeds
• Perform actions like posting, liking, and following
• Retrieve profile details and follower/following lists
• Convert Bluesky URLs to AT URI format

Use cases of Bluesky MCP Server

• "Get recent posts from David Roberts" using natural language
• "Find me a feed about Seattle and tell me what people are talking about"
• "Analyze my liked posts and give me interesting insights"
• "Write a haiku and post it to Bluesky"
• "Search posts about #teslatakedown and summarize recent events"

FAQ from Bluesky MCP Server

What dependencies are required?

Node.js and pnpm are needed for installation. The server connects to the ATProtocol via Bluesky's API.

How is authentication handled?

You must create an app password in Bluesky Settings > App Passwords and set it as the BLUESKY_APP_PASSWORD environment variable.

Where does session data live?

Session information is stored in memory only and is not shared with the MCP client. The MCP client only has access to the tools, not to authentication credentials.

What transport does the server use?

The server uses standard MCP stdio transport, configured as a command in the MCP client's configuration (e.g., node build/src/index.js).

Can I test without an LLM?

Yes, you can use the MCP Inspector by running npx @modelcontextprotocol/inspector node build/src/index.js and setting the required environment variables.