Bluesky Social MCP

What gwbischof/bluesky-social-mcp MCP server does

The gwbischof/bluesky-social-mcp MCP server connects MCP-compatible agents to Bluesky through the atproto client. It covers both read and write operations for an authenticated Bluesky account, including profile lookups, relationship management, feed retrieval, post interactions, and publishing.

Read operations can inspect a profile, resolve a handle to a DID, list follows or followers, retrieve the home timeline, fetch an author's feed, read a post, inspect likes, retrieve repost information, and load a complete post thread. Write operations can follow, unfollow, mute, or unmute accounts; like or unlike posts; repost or remove reposts; and delete posts.

How it works

The server is configured as a local MCP process. Its client session uses two environment variables: BLUESKY_IDENTIFIER for the account handle or identifier and BLUESKY_APP_PASSWORD for the Bluesky app password. The README directs users to create that app password in Bluesky's account settings.

The documented quick-start configuration runs uvx with the repository pinned to the v0.1 Git tag and starts the bluesky-social-mcp entry point. Pinning the source version is recommended in the project instructions so upgrades happen through an explicit configuration change. A local checkout can instead be started with uv and the project's server.py entry point.

Setup and configuration

Create a Bluesky app password, then add the server to the MCP client's configuration with the required environment variables. The documented remote-source command is:

{
  "command": "uvx",
  "args": ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"]
}

Add BLUESKY_IDENTIFIER and BLUESKY_APP_PASSWORD under the configuration's env object. For development, the repository instructions use uv sync to install dependencies and uv run bluesky-social-mcp to run the project. The README also documents MCP Inspector commands and a pytest command for testing against the actual Bluesky service.

Tools and capabilities

The gwbischof/bluesky-social-mcp MCP server provides tools in these groups:

• Authentication: check whether the current session is authenticated.
• Profiles and relationships: retrieve profiles, follows, and followers; resolve handles; follow, unfollow, mute, and unmute users.
• Feeds and conversations: read the home timeline, an author's feed, or a full post thread.
• Engagement: like and unlike posts, list likes, repost and unrepost, and list accounts that reposted a post.
• Publishing and management: create text posts, send one or multiple images, send video, retrieve a specific post, and delete a post.

Limitations and notes

The provided material describes an authenticated Bluesky workflow and does not document anonymous access. A valid Bluesky identifier and app password are therefore required for the documented setup. The README does not specify compatibility with individual MCP clients, operating systems, rate limits, pagination behavior, or detailed input schemas for each tool. Tests are described as running against the live Bluesky service, so test execution depends on the configured account and network access.