Bluesky MCP Server

Bluesky MCP Server

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

2. Build the project:

npm run build

3. 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