How to add Bluesky Context Server to Windsurf
Query your Bluesky profile, timeline, posts, likes, and search from your AI assistant. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.
Last updated June 14, 2026 · 31★ · stdio · apikey
Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
- 2Paste the Bluesky Context Server config below.
- 3Fill in placeholder secrets, then save.
- 4Click Refresh in the MCP panel.
- 5Bluesky Context Server's tools become available to Cascade.
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 Windsurf
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 + Windsurf FAQ
Where is the Windsurf config file?
Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?
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.