How to add Bluesky Context Server to Claude Desktop
Query your Bluesky profile, timeline, posts, likes, and search from your AI assistant. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 31★ · stdio · apikey
Claude Desktop config for Bluesky Context Server
npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude{
"mcpServers": {
"bluesky-context-server": {
"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"
}
}
}
}Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Bluesky Context Server config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Bluesky Context Server's tools appear under the 🔌 tools menu.
Before you start
- A Bluesky account
- A Bluesky App Password (created under Settings -> Privacy and Security -> App Passwords)
- Bun, or Node.js v22.6.0+
What Bluesky Context Server can do in Claude Desktop
bluesky_get_profileGet your Bluesky profile information including display name, bio, follower count, etc. Takes no parameters.
bluesky_get_followsGet a list of accounts you follow. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_get_followersGet a list of accounts following you. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_get_postsGet your recent posts with engagement data. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_get_personal_feedGet your personalized Bluesky timeline/feed. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_get_liked_postsGet posts you've liked. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_search_postsSearch for posts across Bluesky. Required parameter: query. Optional parameters: limit (default 50, max 100) and cursor for pagination.
bluesky_search_profilesSearch for Bluesky user profiles. Required parameter: query. Optional parameters: limit (default 50, max 100) and cursor for pagination.
Security
Requires a Bluesky App Password (not your account password), created at Bluesky Settings -> Privacy and Security -> App Passwords. Credentials are supplied via the BLUESKY_IDENTIFIER and BLUESKY_APP_KEY environment variables in your local Claude Desktop config and are used to authenticate to your own account.
Bluesky Context Server + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Bluesky Context Server config there under the "mcpServers" key and restart the client.
Is Bluesky Context Server safe to use with Claude Desktop?
Requires a Bluesky App Password (not your account password), created at Bluesky Settings -> Privacy and Security -> App Passwords. Credentials are supplied via the BLUESKY_IDENTIFIER and BLUESKY_APP_KEY environment variables in your local Claude Desktop config and are used to authenticate to your own account.
Do I use my regular Bluesky password?
No. You must use a Bluesky App Password (BLUESKY_APP_KEY), created under Settings -> Privacy and Security -> App Passwords, not your regular account password.
What runtime is required?
Either Bun or Node.js v22.6.0 or newer. The server runs locally over stdio.
What's the easiest way to install it?
Use Smithery: run `npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude`, then add your Bluesky credentials to the generated configuration. Alternatively, clone the repo and configure Claude Desktop manually.