How to add Bluesky Context Server to Cursor
Query your Bluesky profile, timeline, posts, likes, and search from your AI assistant. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 31★ · stdio · apikey
Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the Bluesky Context Server config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of Bluesky Context Server's tools to confirm it's connected.
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 Cursor
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 + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Bluesky Context Server config there under the "mcpServers" key and restart the client.
Is Bluesky Context Server safe to use with Cursor?
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.