MCP.so
Sign In

Bluesky Context Server

@laulauland

About Bluesky Context Server

Bluesky MCP server

Basic information

Category

Other

License

MIT

Runtime

node

Transports

stdio

Publisher

laulauland

Config

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

{
  "mcpServers": {
    "bluesky-context-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@laulauland/bluesky-context-server",
        "--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 Context Server?

Bluesky Context Server is a Model Context Protocol (MCP) server that enables MCP clients like Claude Desktop to interact with Bluesky. It lets you query your profile, search posts, get your timeline, and more directly from your AI assistant.

How to use Bluesky Context Server?

Install via Smithery (recommended) with npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude or manually configure the server in your Claude Desktop config file. You need a Bluesky account, an App Password (not your regular password), and either Bun or Node.js v22.6.0+. Set the environment variables BLUESKY_APP_KEY and BLUESKY_IDENTIFIER in the configuration.

Key features of Bluesky Context Server

  • Query your own Bluesky profile information
  • Get your recent posts and engagement data
  • View your personalized Bluesky timeline
  • Search posts and user profiles across Bluesky
  • List followers and accounts you follow
  • See posts you have liked

Use cases of Bluesky Context Server

  • Ask an AI assistant to show your Bluesky profile or bio
  • Search for posts on a specific topic without leaving your chat
  • Quickly review your timeline or recent posts
  • Find Bluesky users interested in a particular subject
  • Check who your recent followers are

FAQ from Bluesky Context Server

What credentials do I need?

You need your Bluesky handle (BLUESKY_IDENTIFIER) and an App Password (BLUESKY_APP_KEY) generated from Bluesky settings – not your regular account password.

How do I install the server?

The recommended method is using Smithery: npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude. Alternatively, you can clone the repo and configure Claude Desktop manually with either Bun or Node.js.

What tools does Bluesky Context Server provide?

It provides MCP tools for profile (get profile, follows, followers), posts/feed (get posts, personal feed, liked posts), and search (search posts, search profiles). Each supports optional pagination with limit (max 100) and cursor.

Why am I getting "Authentication failed"?

Double-check that your BLUESKY_APP_KEY and BLUESKY_IDENTIFIER are correct. Ensure you are using an App Password, not your regular Bluesky password.

What runtime dependencies are required?

You need either Bun or Node.js v22.6.0+. The server file packages/server/bin/index.ts must have execute permissions and the correct path in the Claude config.

Comments

More Other MCP servers