Bluesky

Provides a Bluesky MCP server to post on your behalf via AT Protocol with authentication and post interactions.

typescript

5

GitHub Stars

typescript

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": {
    "semioz-bluesky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@semihberkay/bluesky-mcp"
      ],
      "env": {
        "BLUESKY_PASSWORD": "your-app-password",
        "BLUESKY_IDENTIFIER": "your.handle.bsky.social"
      }
    }
  }
}

You can run a Bluesky MCP Server that authenticates with Bluesky and lets you post, like, repost, and manage timelines through a simple MCP client. It handles authentication and provides a set of tools to interact with Bluesky using the AT Protocol on your behalf.

How to use

Use the MCP client to authenticate with Bluesky, create posts, manage timelines, and interact with posts on Bluesky without switching apps. You can perform actions such as logging in with credentials, posting text and images, liking posts, reposting, and retrieving profiles or timelines. The server can auto-login using environment variables you configure, or you can run the login tool to provide credentials for a specific session.

How to install

Prerequisites: You need Node.js and npm installed on your machine. Ensure you have a supported shell to run the commands.

Step 1: Install via Smithery to enable Claude Desktop integration.

npx -y @smithery/cli install @semioz/bluesky-mcp --client claude

Step 2: Manual installation for Claude Desktop configuration.

{
  "mcpServers": {
    "bluesky-mcp": {
      "command": "npx",
      "args": ["-y", "@semihberkay/bluesky-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
        "BLUESKY_PASSWORD": "your-app-password"
      }
    }
  }
}

Step 3: Ensure required environment variables are set in Claude’s config or your environment.

Configuration details and environment

The server requires Bluesky credentials to operate. You can provide credentials via environment variables or supply them at login time using the provided tools.

Usage basics

Authentication: You can log in with your Bluesky handle or email and password, or rely on environment variables set in your config for automatic login when the server starts.

Posts: Create new posts with optional images, fetch individual posts or multiple posts by URI, and delete posts as needed.

Interactions: Like posts, unlike posts, repost, and unrepost. Track engagement and manage content directly through the MCP client.

Profile & Timeline: Retrieve your profile and fetch your timeline with an optional limit on the number of posts.

Prompts

Format Timeline: Convert timeline data into a readable format that includes author, post text, engagement metrics, timestamps, and embedded content.

Available tools

login

Authenticate with Bluesky using an identifier and password. If env vars are set, auto-login may occur on startup.

create-post

Create a new post with text content and optional images encoded as Base64 data with their mime types.

get-post

Fetch a single post by its URI.

get-posts

Fetch multiple posts by providing an array of post URIs.

delete-post

Delete a post by its URI.

like-post

Like a post by providing its URI and the post CID.

unlike-post

Remove a like using the like URI.

repost

Repost a post by providing its URI and the original post CID.

unrepost

Remove a repost by specifying the repost URI.

get-profile

Retrieve your Bluesky profile information.

get-timeline

Fetch your timeline with an optional limit on the number of posts.

format-timeline

Format timeline data into a readable summary with author, text, engagement, and timestamps.