Bluesky Social MCP
An MCP server for interacting with the Bluesky social network via the atproto client.
👋 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/bluesky-social-mcp@v0.1", "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
-
Install dependencies:
uv sync -
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
Metadata
Release files for iflow-mcp_gwbischof-bluesky-social-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_gwbischof_bluesky_social_mcp-0.1.0.tar.gz | 14.6 kB | Without provenance | Details for iflow_mcp_gwbischof_bluesky_social_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_gwbischof_bluesky_social_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_gwbischof_bluesky_social_mcp-0.1.0-py3-none-any.whl |
Total release size: 23.9 kB
Security for iflow-mcp_gwbischof-bluesky-social-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.