Skip to main content
Glama
Bluesky MCP Server

Bluesky MCP Server

by kud

Bluesky MCP Server

 ██████╗ ███████╗██╗  ██╗██╗   ██╗
 ██╔══██╗██╔════╝██║ ██╔╝╚██╗ ██╔╝
 ██████╔╝███████╗█████╔╝  ╚████╔╝
 ██╔══██╗╚════██║██╔═██╗   ╚██╔╝
 ██████╔╝███████║██║  ██╗   ██║
 ╚═════╝ ╚══════╝╚═╝  ╚═╝   ╚═╝

TypeScript Node.js MCP npm License

Search, read, and post to Bluesky from any MCP client — a thin server over the @kud/bsky AT Protocol library.

Features • Quick Start • Tools • Development

🌟 Features

  • App-password auth — uses your Bluesky App Password via BLUESKY_HANDLE / BLUESKY_APP_PASSWORD (shared with @kud/bsky-cli).

  • 11 tools — 5 read, 6 write.

  • Writes are gated — every posting/engagement tool requires an explicit confirm: true, so an agent can never publish by accident.

  • Thin wrapper — each tool is one line over @kud/bsky; the API logic lives in the core library, not here.

  • TypeScript, ESM, zero business logic — @modelcontextprotocol/sdk + zod.

Related MCP server: bluesky-mcp

🚀 Quick Start

Prerequisites

  • Node.js 20+

  • A Bluesky account and an App Password (Settings → App Passwords)

Installation

npx @kud/mcp-bsky

Claude Desktop / Claude Code

{
  "mcpServers": {
    "bsky": {
      "command": "npx",
      "args": ["@kud/mcp-bsky"],
      "env": {
        "BLUESKY_HANDLE": "you.bsky.social",
        "BLUESKY_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
      }
    }
  }
}

✅ Restart your client and the bsky tools appear.

🛠️ Available Tools

🔭 Read (5 tools)

Tool

Description

search_posts

Search Bluesky for posts matching a query

timeline

The authenticated user's home timeline

notifications

The authenticated user's notifications

profile

A profile by handle or DID

thread

A post and its replies

✍️ Write — gated by confirm: true (6 tools)

Tool

Description

post

Publish a post

thread_post

Publish a self-thread (each post replies to the previous)

reply

Reply to a post

like

Like a post

repost

Repost a post

follow

Follow an account

Total: 11 tools covering the core Bluesky workflow.

💬 Example Conversations

You: "What are people saying about the AT Protocol on Bluesky?"
AI: *calls search_posts → summarises the latest posts*

You: "Post 'shipped a new MCP server 🦋' to my Bluesky."
AI: *calls post with confirm: true → returns the post URL*

You: "Reply to that thread and like the original."
AI: *calls reply and like (confirm: true) → done*

🧪 Development

git clone https://github.com/kud/mcp-bsky.git
cd mcp-bsky
npm install
npm run build
npm test

Script

Description

npm run build

Compile TypeScript to dist/

npm run dev

Run from source via tsx

npm test

Run the vitest suite

npm run inspect:dev

Launch the MCP Inspector against source

Test against source with the Inspector:

export BLUESKY_HANDLE=you.bsky.social
export BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx
npm run inspect:dev

🔐 Authentication

This server reads two environment variables — @kud/bsky's contract, intentionally not MCP_-prefixed so the credentials are shared with @kud/bsky-cli:

  1. Sign in at bsky.app → Settings → App Passwords → Add App Password.

  2. Set BLUESKY_HANDLE (e.g. you.bsky.social) and BLUESKY_APP_PASSWORD (the generated app password — never your main password).

📊 Tech Stack

  • Runtime: Node.js 20+

  • Language: TypeScript (ESM)

  • Protocol: Model Context Protocol (@modelcontextprotocol/sdk)

  • Core: @kud/bsky

  • Validation: zod

📄 License

MIT — see LICENSE.

🙏 Acknowledgments

Made with ❤️ for the terminal

⭐ Star this repo if it helped you!

Available Tools

11 tools
followB

Follow an account. Requires confirm: true.

Inputs: handle (required), confirm.

likeC

Like a post. Requires confirm: true.

Inputs: url (required), confirm.

notificationsC

Get the authenticated user's notifications.

Inputs: limit.

postA

Publish a Bluesky post. Requires confirm: true.

Inputs: text (required), confirm.

profileB

Get a Bluesky profile by handle or DID.

Inputs: actor (required).

replyC

Reply to a post. Requires confirm: true.

Inputs: url (required), text (required), confirm.

repostB

Repost a post. Requires confirm: true.

Inputs: url (required), confirm.

search_postsB

Search Bluesky for posts matching a query.

Inputs: query (required), limit.

threadA

Get a post and its replies.

Inputs: url (required).

thread_postA

Publish a self-thread (each post replies to the previous). Requires confirm: true.

Inputs: posts (required), confirm.

timelineC

Get the authenticated user's home timeline.

Inputs: limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: follow, like, post, reply, repost, search, thread operations, profile retrieval, notifications, and timeline. No overlapping functionality.

    Naming Consistency4/5

    Tools use consistent lowercase and underscores for compound names, but mix verb names (follow, like) with noun names (notifications, profile, thread, timeline). While readable, the pattern is not entirely uniform.

    Tool Count5/5

    With 11 tools, the server covers the essential Bluesky operations (posting, reading, searching, interacting) without being bloated or too sparse. The count fits the domain well.

    Completeness4/5

    Core workflows like posting, replying, searching, and timeline reading are covered. Minor gaps exist: no tools for unfollowing, unliking, or deleting posts, but the surface is sufficient for most agent tasks.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables LLMs to interact with the AT Protocol ecosystem, including Bluesky, through natural language. Supports public data access without authentication and full write operations with authentication.
      51
      145 npm
      10
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables interacting with Bluesky/AT Protocol through MCP tools for posting, replying, media, timelines, and a human-approved outbox system.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for managing a Bluesky account, enabling posting, replying, liking, reposting, following, searching, and reading timelines/notifications via natural language.
      18
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Bluesky social network through the AT Protocol, including searching posts, fetching profiles, browsing feeds, and retrieving threads and follower data.
      90 npm
      MIT