io.github.cyanheads/bluesky-mcp-server MCP Server

io.github.cyanheads/bluesky-mcp-server

Repository Registry

What is the io.github.cyanheads/bluesky-mcp-server MCP server?

Search posts, profiles, feeds, threads, and trending topics on Bluesky.

How to install io.github.cyanheads/bluesky-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

BLUESKY_IDENTIFIER
Handle, DID, or email of the Bluesky account post search runs as. Optional: without it and BLUESKY_APP_PASSWORD, bsky_search_posts is not offered, since Bluesky refuses search without a signed-in account. Use a dedicated account — search leaves out posts from accounts in a block relationship with it.
BLUESKY_APP_PASSWORD
secret
App password for BLUESKY_IDENTIFIER (a standard, non-privileged one — Settings → Privacy and security → App passwords). Optional; required together with BLUESKY_IDENTIFIER to enable bsky_search_posts.
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bluesky-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/bluesky-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<YOUR_BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<YOUR_BLUESKY_APP_PASSWORD>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}