Bsky MCP Server

MCP server for Bluesky

Local serverstdioGo

What is the Bsky MCP Server?

MCP server for Bluesky

What it actually does

You can use this MCP server to bring context from various Bluesky / ATProtocol API endpoints directly into the context window of your LLM based application. For example, you can add this server to Claude Desktop and then use it as a natural language Bluesky client.

  • Interact with common Bluesky features via natural language (e.g. "Get recent posts from David Roberts")
  • Fetch and analyze feeds ("Find me a feed about Seattle and tell me what people are talking about")
  • Fetch and analyze lists of followers ("What types of accounts does Mark Cuban follow? Give me a detailed report")
  • Use an LLM to write a post and then post it for you 😱 ("Write a haiku about today's weather in my area and post it to bluesky")
  • Search for feeds, posts, and people ("Find posts about the #teslatakedown and give me a summary of recent events")
  • Analyze who follows you? ("Who follows me on Bluesky? Give me a report")

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get-pinned-feedsreturns the set of all "pinned" items from the authenticated user's preferences.
get-timeline-postsreturns posts from the authenticated user's home timeline
get-feed-postsreturns posts from the specified feed
get-list-postsreturns posts from the specified list
get-user-postsreturns the specified user's posts
get-profilereturns the profile details of the specified user
get-followsreturns the set of users an account follows
get-followersreturns the set of users who follow an account
get-liked-postsreturns recent posts liked by the authenticated user
get-trendsreturns current trending topics on Bluesky with post counts
get-post-threadreturns a full conversation thread for a specific post, showing all replies and context
convert-url-to-uriconverts a Bluesky web URL to an AT URI format that can be used with other tools
search-postsreturns posts for a given query. can specify top or latest
search-peoplereturns people for a given search query

How to install the Bsky MCP Server

{
  "mcpServers": {
    "bluesky": {
      "command": "node",
      "args": [
        "/path/to/bsky-mcp-server/build/src/index.js"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "your-bluesky-handle",
        "BLUESKY_APP_PASSWORD": "YOUR_BLUESKY_APP_PASSWORD",
        "BLUESKY_SERVICE_URL": "https://bsky.social"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
BLUESKY_IDENTIFIERDeclared in the maintainer’s client configuration.Check documentation
BLUESKY_APP_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
BLUESKY_SERVICE_URLDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Bsky to get-pinned-feeds.”
  • “Use Bsky to get-timeline-posts.”
  • “Use Bsky to get-feed-posts.”

Frequently asked questions

MCP server for Bluesky Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.