Bluesky Social MCP

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):

• 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.

Dev Setup

1. Install dependencies:
   uv sync
2. Run the server:
   uv run bluesky-social-mcp

Debug with MCP Inspector

Run the tests

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