🦋 Model Context Protocol server for Bluesky / AT Protocol — post & read as you, or read anything public with no login (couchsky). 24 tools.
  • TypeScript 87.1%
  • JavaScript 12.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-15 18:11:26 -05:00
.github/workflows Validate on standard Node 22 runner without policy changes 2026-10-09 16:12:14 +09:00
assets docs: add SVG hero banner to the README 2026-07-27 04:58:35 +02:00
docs bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
src feat(mcp): silence dotenv@17 stdout banner, fix UTF-8 facet byte offsets, and add bluesky_thread multipost tool 2026-10-30 16:07:18 +09:00
tests Support anonymous startup and bound authentication retries 2026-10-05 20:10:36 -04:00
.env.example bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
.gitignore bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
AGENTS.md bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
LICENSE bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00
package-lock.json Merge pull request #3 from 8b-is/dependabot/npm_and_yarn/hono/node-server-2.1.6 2026-11-15 18:11:26 -05:00
package.json build(deps): bump zod from 4.4.3 to 4.6.7 2026-11-06 10:40:15 +00:00
README.md Support anonymous startup and bound authentication retries 2026-10-05 20:10:36 -04:00
tsconfig.json bluesky-mcp — MCP server for Bluesky / AT Protocol (OSS, MIT) 2026-07-27 03:40:26 +02:00

bluesky-mcp — a Model Context Protocol server for Bluesky and the AT Protocol

🦋 bluesky-mcp

A Model Context Protocol server for Bluesky / the AT Protocol — give any MCP-capable agent (Claude, etc.) the ability to post, read, and browse Bluesky.

Two access modes, one server:

  • Account tools (bluesky_*) act as your logged-in account — post, reply, like, repost, follow, and read your timeline + notifications. Needs an app password.
  • couchsky tools (couchsky_*) are public, read-only, no login — read any profile, feed, or thread through the public AppView. The read-only "Couch Sky" way; needs no credentials.

24 tools · TypeScript · stdio transport · MIT.

Install

git clone https://github.com/8b-is/bluesky-mcp.git
cd bluesky-mcp
npm install
npm run build

Configure (only for the account tools)

Copy .env.example to .env and fill in an app password (Bluesky → Settings → App Passwords — never your main password):

BLUESKY_IDENTIFIER="your-handle.bsky.social"
BLUESKY_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"

The server loads .env from its own directory, so it works no matter where your client launches it. The couchsky_* read tools need none of this.

Connect an MCP client

Point your client at the built server (Claude Code, Claude Desktop, etc.):

{
  "mcpServers": {
    "bluesky": {
      "command": "node",
      "args": ["/absolute/path/to/bluesky-mcp/dist/index.js"]
    }
  }
}

Prefer passing secrets through the client? Add an "env": { "BLUESKY_IDENTIFIER": "…", "BLUESKY_APP_PASSWORD": "…" } block instead of a .env. Restart the client to load it.

Tools

Post & act — as you bluesky_post · bluesky_reply · bluesky_like · bluesky_repost · bluesky_follow · bluesky_delete_post

Read — your account bluesky_whoami · bluesky_timeline · bluesky_notifications · bluesky_notification_count · bluesky_get_post · bluesky_get_thread · bluesky_get_author_feed · bluesky_get_likes · bluesky_get_profile · bluesky_search · bluesky_search_actors · bluesky_get_followers · bluesky_get_follows · bluesky_resolve_handle

couchsky — public, read-only, no login couchsky_profile · couchsky_author_feed · couchsky_thread · couchsky_search

The agent-facing guide — when to use which, and posting etiquette — is in AGENTS.md.

Develop

npm run dev      # tsx, live source
npm run build    # tsc → dist/

License

MIT © Peter Lodri · 🜂 ahogy a dolgok vannak

Anonymous startup and tests

The server starts without account credentials for couchsky_* public reads. Account tools validate BLUESKY_IDENTIFIER and BLUESKY_APP_PASSWORD when called. Run npm test to build and exercise a real SDK stdio session with synthetic public responses, no credentials, and no external network requests.