Bluesky

A Bluesky MCP

python

15

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "gwbischof-bluesky-social-mcp": {
      "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"
      }
    }
  }
}

This MCP server enables you to interact with Bluesky via the atproto client. It provides end-to-end actions for authentication, profile and feed operations, post creation, engagement, and more, so you can manage Bluesky activities directly through MCP clients.

How to use

You connect to the Bluesky MCP server from your MCP client and then issue RPC-like calls to perform common Bluesky actions. You can authenticate, read and modify profiles, view timelines, create posts with text or media, like and repost content, and manage followers. Use the client’s standard MCP request/response flow to invoke the tools exposed by this Bluesky MCP server.

How to install

Prerequisites: you need a Bluesky account and an app password generated from your Bluesky settings. You also need the MCP runtime tools available in your environment.

Create or edit your MCP configuration file to include the Bluesky MCP server entries shown below. You can pin the version to ensure stability.

{
  "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"
      }
    }
  }
}

Additional setup for local runs

If you run from a local clone of the Bluesky MCP repository, use the following runtime configuration.

{
  "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"
      }
    }
  }
}

Security and notes

Keep your Bluesky app password secure. Pinning the version in your config helps you avoid unexpected breaking changes when you update the MCP. Use separate credentials or environment isolation for production deployments.

Available tools

check_auth_status

Check if the current Bluesky MCP session is authenticated.

get_profile

Fetch a user profile by handle or DID.

get_follows

List users followed by a given account.

get_followers

List users who follow a given account.

follow_user

Follow a user.

unfollow_user

Unfollow a user.

mute_user

Mute a user.

unmute_user

Unmute a user.

resolve_handle

Resolve a Bluesky handle to a DID.

get_timeline

Retrieve posts from your home timeline.

get_author_feed

Get posts from a specific author.

get_post_thread

Get a full conversation thread.

like_post

Like a post.

unlike_post

Unlike a post.

get_likes

Get likes for a post.

repost

Repost a post.

unrepost

Remove a repost.

get_reposted_by

Get users who reposted a post.

send_post

Create a new text post.

send_image

Post with a single image.

send_images

Post with multiple images.

send_video

Post with a video.

delete_post

Delete a post.

get_post

Retrieve a specific post.

get_posts

Get multiple posts in one request.