Bluesky MCP Server

Name: Bluesky MCP Server
Author: semioz

@semioz

Repository Homepage

About Bluesky MCP Server

mcp server for bluesky. featured in offical mcp server repo.

#mcp #claude #bluesky #atproto #model-context-protocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bluesky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@semioz/bluesky-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Bluesky MCP Server?

The Bluesky MCP Server is a Model Context Protocol server that enables AI assistants (like Claude) to interact with Bluesky via the AT Protocol. It allows users to read and write posts, manage interactions, and view profiles and timelines through MCP-compatible clients.

How to use Bluesky MCP Server?

Install automatically via Smithery (npx -y @smithery/cli install @semioz/bluesky-mcp --client claude) or manually by adding a configuration entry to claude_desktop_config.json with environment variables BLUESKY_IDENTIFIER and BLUESKY_PASSWORD. After setup, the server auto-logs in; you can use the login tool if you need different credentials or if auto-login fails.

Key features of Bluesky MCP Server

Authenticate with Bluesky using handle/email and app password
Create text posts with optional image uploads (base64)
Retrieve single or multiple posts by URI
Delete your posts
Like/unlike and repost/unrepost content
View your profile and timeline (up to 100 posts)
Automatic link and mention detection in rich text
MCP compatible – works with Claude Desktop and other MCP clients

Use cases of Bluesky MCP Server

Let an AI assistant post updates on your Bluesky account
Automate reading and responding to your timeline
Manage likes and reposts without opening the Bluesky app
Fetch and format your timeline for review or summarization
Integrate Bluesky interactions into chat-based workflows

FAQ from Bluesky MCP Server

What environment variables do I need?

You must set BLUESKY_IDENTIFIER (your Bluesky handle or email) and BLUESKY_PASSWORD (your Bluesky app password) in the Claude Desktop config file.

When should I use the login tool?

The server auto-logs in using environment variables. Use the login tool if you haven’t set those variables, want to use different credentials, or auto-login failed.

Can I create posts with images?

Yes. The create-post tool accepts an optional images array containing base64-encoded image data and the MIME type (e.g., image/jpeg).

How do I get my timeline?

Use the get-timeline tool with an optional limit parameter (maximum 100). The format-timeline prompt can then format the returned data with author info, text, engagement metrics, timestamps, and embedded content.

How does authentication work?

Credentials are provided via environment variables or the login tool. The server uses the AT Protocol to authenticate with Bluesky; an app password is required, not your main account password.