Bluesky MCP Server (TadMSTR Fork)

This is an actively maintained fork of brianellin/bsky-mcp-server. The upstream repository appears unmaintained as of early 2026. This fork adds bug fixes and features from open PRs that were never merged, plus additional tools not present in upstream.

A Model Context Protocol server that connects to Bluesky and provides tools to interact with the ATProtocol.

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.

Changes in this fork

• Quote post support: create-post now accepts an optional quotePost URI parameter to quote another post
• Automatic facet detection: Uses RichText.detectFacets() from @atproto/api to automatically resolve mentions, hashtags, and URLs in posts so they render as proper links on Bluesky
• Repost / delete / unlike / unfollow: Write actions beyond just posting and liking
• Block and mute lists: get-blocks and get-mutes to inspect your moderation state
• Post engagement: get-reposts and get-quotes to see who reposted or quoted a specific post
• Notifications: get-notifications with optional type filtering
• Post likes: get-post-likes to see who liked a specific post
• Trends: get-trends with post counts and trending start times

Features & Tools

• 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")

Reading

• get-my-handle-and-did: returns the handle and DID of the authenticated user
• get-timeline-posts: returns posts from the authenticated user's home timeline
• get-notifications: returns notifications, optionally filtered by type (reply, mention, like, repost, follow, quote)
• get-pinned-feeds: returns all pinned feeds and lists from the authenticated user's preferences
• get-feed-posts: returns posts from a specified feed
• get-list-posts: returns posts from a specified list
• get-user-posts: returns a specified user's posts
• get-profile: returns profile details for a specified user
• get-follows: returns the set of users an account follows
• get-followers: returns the set of users who follow an account
• get-liked-posts: returns recent posts liked by the authenticated user
• get-post-likes: returns users who liked a specific post
• get-reposts: returns users who reposted a specific post
• get-quotes: returns posts that quote a specific post
• get-post-thread: returns a full conversation thread for a specific post, showing all replies and context
• get-trends: returns current trending topics on Bluesky with post counts and trending start times
• get-blocks: returns the list of accounts you have blocked
• get-mutes: returns the list of accounts you have muted
• search-posts: returns posts for a given query; can specify top or latest
• search-people: returns people for a given search query
• search-feeds: returns feeds for a given query
• convert-url-to-uri: converts a Bluesky web URL to an AT URI for use with other tools
• list-resources: lists available MCP resources with descriptions

Writing

• create-post: publish a post, with optional reply and quote post support; facets (mentions, hashtags, URLs) are auto-detected
• repost: repost a specific post
• delete-post: delete one of your own posts
• like-post: like a specific post
• unlike: remove a like from a post
• follow-user: follow a specific user
• unfollow: unfollow a specific user

Tips:

• You can ask for posts from search, timelines, lists, feeds, or profiles by time range. For example: "Summarize posts from my timeline for the last three days" or "Find me the most interesting article people have been talking about this week"
• Get weird: "What's the funniest/most unhinged/weirdest/goofiest post you've seen on my timeline in the last 24 hours?"
• Learn about yourself: "Analyze my liked posts and tell me what I'm into. Give me 3 interesting facts about what you've found and how it relates to my personality on bluesky" or "Who follows me on bluesky? Give me a comprehensive report."

Installation

Installing Manually

Clone this repo, then install dependencies and build the server:

# Install dependencies
npm install

# Build the project
npm run build

Testing with MCP Inspector

You can test the bluesky tools directly without connecting to an LLM via the amazing MCP Inspector. First make sure you have built the server and then run:

npx @modelcontextprotocol/inspector node build/src/index.js

Navigate to the local URL provided in your terminal, and then set your BLUESKY_IDENTIFIER, BLUESKY_APP_PASSWORD, and BLUESKY_SERVICE_URL environment variables from the panel on the left. Try the get-timeline tool to see the most recent posts from your home timeline.

MCP Client Configuration

Follow the steps to set up MCP with your client of choice. For example, to set up Claude for desktop to connect to Bluesky, add the following bluesky section to your claude_desktop_config.json:

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

For more details about running MCP servers in Claude for desktop, see https://modelcontextprotocol.io/quickstart/user

Creating App Passwords

To use this MCP server, you need to create an app password for your Bluesky account:

1. Log in to Bluesky
2. Go to Settings > App Passwords
3. Create a new app password specifically for this integration
4. Set the app password using the BLUESKY_APP_PASSWORD environment variable

Security Notes

• This server stores your session information in memory only and does not share it with the MCP client.
• The MCP client only has access to the tools, not to your authentication or app password

License

MIT