Bluesky Context Server

Bluesky MCP server

typescript

30

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "laulauland-bluesky-context-server": {
      "command": "bun",
      "args": [
        "/path/to/bluesky-context-server/packages/server/bin/index.ts"
      ],
      "env": {
        "BLUESKY_APP_KEY": "your-app-password-here",
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social"
      }
    }
  }
}

You can use Bluesky Context Server as an MCP server to let your AI assistant access Bluesky data. It exposes endpoints to query your Bluesky profile, fetch timelines and posts, and perform searches, all through MCP so your assistant can act on Bluesky data safely and automatically.

How to use

Connect your MCP client to Bluesky Context Server and start making requests to fetch your Bluesky profile, timelines, posts, followers, and search results. You can ask your AI assistant to load your profile, show your recent posts, read your personal feed, or search for posts and profiles on Bluesky. Use the server as a data source that your assistant can query on demand, and handle results within your chat context.

How to install

Prerequisites you need before installation are a runtime environment and Bluesky credentials.

Option A: Installing via Smithery (Recommended) to set up Bluesky Context Server automatically for Claude Desktop.

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

Option B: Manual Installation

Follow these steps to configure Claude Desktop to use the Bluesky MCP server manually.

Using Bun:

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "/Users/your-username/.bun/bin/bun",
			"args": [
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

Using Node.js

Configure Claude to run the MCP server with Node.js.

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "node",
			"args": [
				"--experimental-strip-types",
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

3. Restart Claude Desktop

Restart Claude Desktop to apply the MCP server configuration.

Testing the Connection

After setup, test the connection by asking Claude to fetch Bluesky data, such as your profile, recent posts, or to search Bluesky for a topic.

Available tools

bluesky_get_profile

Get your Bluesky profile information including display name, bio, follower count, etc.

bluesky_get_follows

Get a list of accounts you follow with optional pagination.

bluesky_get_followers

Get a list of accounts following you with optional pagination.

bluesky_get_posts

Get your recent posts along with engagement data.

bluesky_get_personal_feed

Get your personalized Bluesky timeline/feed.

bluesky_get_liked_posts

Get posts you've liked.

bluesky_search_posts

Search for posts across Bluesky with a query.

bluesky_search_profiles

Search for Bluesky user profiles.