gwbischof/bluesky-social-mcp

An MCP server for interacting with the Bluesky social network via the atproto client.

:wave: Leave an issue if you have any problems running this MCP. I should be able to push out fixes pretty quickly.

Quick Start

Get your Bluesky app password at: https://bsky.app/settings/app-passwords

Add the following to your MCP config file (Note that the version is pinned):

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gwbischof/[email protected]", "bluesky-social-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

• For security reasons, I think its best to keep it pinned and manually change your config to update the version.

Tool Status

All tools have been implemented and tested ✅

Authentication & Setup

• ✅ check_auth_status - Check if the current session is authenticated

Profile Operations

• ✅ get_profile - Get a user profile (Client method: get_profile)
• ✅ get_follows - Get users followed by an account (Client method: get_follows)
• ✅ get_followers - Get users who follow an account (Client method: get_followers)
• ✅ follow_user - Follow a user (Client method: follow)
• ✅ unfollow_user - Unfollow a user (Client method: unfollow)
• ✅ mute_user - Mute a user (Client method: mute)
• ✅ unmute_user - Unmute a user (Client method: unmute)
• ✅ resolve_handle - Resolve a handle to DID (Client method: resolve_handle)

Feed Operations

• ✅ get_timeline - Get posts from your home timeline (Client method: get_timeline)
• ✅ get_author_feed - Get posts from a specific user (Client method: get_author_feed)
• ✅ get_post_thread - Get a full conversation thread (Client method: get_post_thread)

Post Interactions

• ✅ like_post - Like a post (Client method: like)
• ✅ unlike_post - Unlike a post (Client method: unlike)
• ✅ get_likes - Get likes for a post (Client method: get_likes)
• ✅ repost - Repost a post (Client method: repost)
• ✅ unrepost - Remove a repost (Client method: unrepost)
• ✅ get_reposted_by - Get users who reposted (Client method: get_reposted_by)

Post Creation & Management

• ✅ send_post - Create a new text post (Client method: send_post)
• ✅ send_image - Send a post with a single image (Client method: send_image)
• ✅ send_images - Send a post with multiple images (Client method: send_images)
• ✅ send_video - Send a post with a video (Client method: send_video)
• ✅ delete_post - Delete a post (Client method: delete_post)
• ✅ get_post - Get a specific post (Client method: get_post)
• ✅ get_posts - Get multiple posts (Client method: get_posts)

Run from local clone of repo.

{
    "mcpServers": {
        "bluesky-social": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/bluesky-social-mcp",
                "run",
                "server.py"
            ]
            "env": {
                "BLUESKY_IDENTIFIER": "user-name.bsky.social‬",
                "BLUESKY_APP_PASSWORD": "app-password-here"
            }
        }
    }
}

Dev Setup

1. Install dependencies:

   uv sync
   

2. Run the server:

   uv run bluesky-social-mcp
   

Debug with MCP Inspector

mcp dev server.py
mcp dev server.py --with-editable .

Run the tests

• I run the tests against the actual Bluesky server.
• The tests will use BLUESKY_IDENTIFIER, and BLUESKY_APP_PASSWORD env vars.

uv run pytest