Provides comprehensive tools for interacting with the Bluesky social network, including authentication, profile operations (following/unfollowing, muting/unmuting users), timeline and feed management, post interactions (liking, reposting), and content creation/management (sending text posts, images, videos, and deleting content).
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
Install dependencies:
uv syncRun 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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Bluesky Social MCP
Related MCP Servers
- MIT License
- MIT License