# gwbischof/bluesky-social-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/gwbischof/bluesky-social-mcp  
**GitHub Stars:** 16  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gwbischof-bluesky-social-mcp

## Description
An MCP server for interacting with Bluesky via the atproto client.

## Tools
Capabilities this server exposes over MCP:

- **check_auth_status**
- **get_profile**
- **get_follows**
- **get_followers**
- **follow_user**
- **follow**
- **unfollow_user**
- **unfollow**
- **mute_user**
- **mute**
- **unmute_user**
- **unmute**
- **resolve_handle**
- **get_timeline**
- **get_author_feed**
- **get_post_thread**
- **like_post**
- **like**
- **unlike_post**
- **unlike**
- **get_likes**
- **repost**
- **unrepost**
- **get_reposted_by**
- **send_post**
- **send_image**
- **send_images**
- **send_video**
- **delete_post**
- **get_post**
- **get_posts**

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

**Requires environment variables:** `BLUESKY_IDENTIFIER`, `BLUESKY_APP_PASSWORD` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

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

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/gwbischof-bluesky-social-mcp/readme_