Bluesky MCP Server

Name: Bluesky MCP Server
Author: brianellin

@brianellin

Repository

About Bluesky MCP Server

Bluesky MCP (Model Context Protocol) Server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bsky-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@brianellin/bsky-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.