bluesky-mcp

bluesky-mcp

2
communication

The Bluesky MCP Server is a Model Context Protocol server designed for automating interactions with Bluesky through the AT Protocol. It provides various features including post creation, profile access, and rich text support, and is compatible with the Claude desktop app.

Bluesky MCP Server

smithery badge

A Model Context Protocol (MCP) server for Bluesky that can post on your behalf by using the AT Protocol.

Setup

Installing via Smithery

To install bluesky-mcp for Claude Desktop automatically via Smithery:

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

Manual Installation

  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. Configure Claude for Desktop:

Open your Claude for Desktop App configuration at ~/Library/Application Support/Claude/claude_desktop_config.json and add:

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

Required Environment Variables

  • BLUESKY_IDENTIFIER: Your Bluesky handle or email
  • BLUESKY_PASSWORD: Your Bluesky app password

Available MCP Tools

Authentication

tool: "login"
params: {
  identifier?: string, // Your Bluesky handle or email (optional if set in env)
  password?: string    // Your Bluesky app password (optional if set in env)
}

The server will attempt to auto-login using credentials from the environment variables when starting up. You only need to use the login tool if:

  • You haven't set the environment variables in Claude's config
  • You want to login with different credentials
  • The auto-login failed

Posts

// Create a new post
tool: "create-post"
params: {
  text: string,           // The text content of your post
  images?: {              // Optional array of images
    data: string,         // Base64 encoded image data
    encoding: string      // Image MIME type (e.g., image/jpeg)
  }[]
}

// Get a single post
tool: "get-post"
params: {
  uri: string            // The URI of the post to fetch
}

// Get multiple posts
tool: "get-posts"
params: {
  uris: string[]        // Array of post URIs to fetch
}

// Delete a post
tool: "delete-post"
params: {
  uri: string           // The URI of the post to delete
}

Interactions

// Like a post
tool: "like-post"
params: {
  uri: string,          // The URI of the post to like
  cid: string          // The CID of the post to like
}

// Unlike a post
tool: "unlike-post"
params: {
  likeUri: string      // The URI of the like to remove
}

// Repost
tool: "repost"
params: {
  uri: string,         // The URI of the post to repost
  cid: string         // The CID of the post to repost
}

// Remove repost
tool: "unrepost"
params: {
  repostUri: string   // The URI of the repost to remove
}

Profile & Timeline

// Get your profile
tool: "get-profile"
params: {}

// Get timeline
tool: "get-timeline"
params: {
  limit?: number      // Number of posts to fetch (max 100)
}

Prompts

Format Timeline

prompt: "format-timeline"
params: {
  timeline: any       // Timeline data to format
}

Formats timeline data in a human-readable way with:

  • Author name/handle
  • Post text
  • Engagement metrics (replies, reposts, likes)
  • Timestamps
  • Embedded content (links, videos)
  • Repost information

Features

  • ✅ Authentication with Bluesky
  • ✅ Create text posts
  • ✅ Support for image uploads
  • ✅ Get user profile
  • ✅ Get timeline
  • ✅ Like/Unlike posts
  • ✅ Repost/Unrepost
  • ✅ Rich text support with automatic link and mention detection
  • ✅ MCP compatible for use with Claude