Skip to content
MCP server

Bluesky MCP Server

Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.8.0
Listing updated
4 days ago

About Bluesky MCP Server

Bluesky MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable HTTP.

Install

Run in a terminal

claude mcp add --transport http bluesky-mcp-server https://bluesky.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://bluesky.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bluesky-mcp-server": {
      "url": "https://bluesky.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bluesky-mcp-server": {
      "type": "http",
      "url": "https://bluesky.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bluesky-mcp-server": {
      "serverUrl": "https://bluesky.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bluesky-mcp-server": {
      "type": "http",
      "url": "https://bluesky.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • BLUESKY_CLAMP_READ_LIMITSClamp oversized read limits with a notice; false restores rejection.
  • BLUESKY_IDENTIFIERHandle, 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_PASSWORDApp 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_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • BLUESKY_CLAMP_READ_LIMITSClamp oversized read limits with a notice; false restores rejection.
  • BLUESKY_IDENTIFIERHandle, 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_PASSWORDApp 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_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Bluesky MCP Server FAQ

Is Bluesky MCP Server free?

Yes. Bluesky MCP Server is open source, so you can use and self-host it for free.

How do I add Bluesky MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http bluesky-mcp-server https://bluesky.caseyjhand.com/mcp