Saturn-VI/bsky-mcp

Bluesky MCP Server

Tools:

• createPost - Creates a post
• createRepost - Reposts a post
• deletePost - Deletes a post
• likePost - Likes a post
• unlikePost - Unlikes a post
• followUser - Follows a user
• unfollowUser - Unfollows a user
• readNotifications - Reads your notifications
• readFeed - Reads a feed given a URI
• readListFeed - Reads a feed given a list URI
• readAuthorFeed - Reads a feed given a DID
• readLikedPosts - Reads your liked posts
• readProfile - Reads a profile given a DID
• listSavedFeeds - Lists your saved feeds
• getFollowers - Gets the users following a user
• getFollowing - Gets the users that are followed by a user
• getTrending - Get trending topics
• searchPosts - Searches posts
• searchUsers - Searches users

Installation

Download the corresponding binary for your platform from the releases page:

• x86 Linux: bsky-mcp-linux-amd64
• Intel Mac: bsky-mcp-darwin-amd64
• M-Series (ARM) Mac: bsky-mcp-darwin-arm64
• x86 Windows: bsky-mcp-windows-amd64.exe

Building from source

Requirements:

• Go

To build, run

$ go build .

Building for all platforms is currently done through a bash script:

$ ./build.sh

This will create binaries for all platforms in the build directory.

Usage

Environmental Variables

ATPROTO_DID: Your Bluesky DID (e.g., did:plc:z72i7hd... or did:web:example.com)

• You can get this by going to PDSls, typing in your handle, and clicking "Copy DID" (or going to the DID Doc tab).

ATPROTO_APP_PASSWORD: Your Bluesky app password (e.g., c7hp-xxxx-xxxx-xxxx)

• You can get this by going to the Bluesky App Passwords page and creating a new app password.
• Don't use your regular password—it'll work, but it's bad practice :(.

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "bsky-mcp": {
      "command": "/path/to/binary/bsky-mcp-<YOUR PLATFORM>",
      "env": {
        "ATPROTO_DID": "your_did_here"
        "ATPROTO_APP_PASSWORD": "your_app_password_here"
      }
    }
  }
}

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

%APPDATA%\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

Claude Code

Run the following from the command line:

$ claude mcp add bsky-mcp -e ATPROTO_DID <YOUR DID> -e ATPROTO_APP_PASSWORD <YOUR APP PASSWORD> -- /path/to/binary/bsky-mcp-<YOUR PLATFORM>

If you have already added the server to your Claude Desktop config, you can run:

$ claude mcp add-from-claude-desktop

and select bsky-mcp from the list.

Gemini CLI

Add the following to your settings.json:

{
  "mcpServers": {
    "bsky-mcp": {
      "command": "/path/to/binary/bsky-mcp-<YOUR PLATFORM>",
      "env": {
        "ATPROTO_DID": "your_did_here",
        "ATPROTO_APP_PASSWORD": "your_app_password_here"
      }
    }
  }
}

~/.config/gemini/settings.json

%USERPROFILE%\.gemini\settings.json