Bluesky Context Server

@laulauland

About Bluesky Context Server

Bluesky MCP server

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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

Frequently asked questions

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?

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

Basic information

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

ICSS

chokcoco

不止于 CSS

20.7K