Bluesky Context Server
Query your Bluesky profile, timeline, posts, likes, and search from your AI assistant.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @smithery/cli install @laulauland/bluesky-context-server --client claudePaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"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"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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+
About Bluesky Context Server
Bluesky Context Server bridges MCP-compatible AI clients and the Bluesky social network. It exposes eight tools covering profile and account info, feeds and posts, and search, so an assistant can answer questions like "What's in my Bluesky feed today?" or "Find Bluesky users interested in AI." The server authenticates with your handle and an App Password and runs locally over stdio using Bun or Node.js v22.6.0+.
Tools & capabilities (8)
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.
When to use it
- Summarize what's in your personalized Bluesky timeline today
- Search Bluesky for posts on a topic such as TypeScript or AI
- Review your most recent followers and the accounts you follow
- Look back at posts you've recently liked
- Find Bluesky users interested in a particular subject
Security notes
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 FAQ
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.
Alternatives to Bluesky Context Server
Compare all alternatives →
Connect your personal WhatsApp: search, read and send messages and media locally
Powerful Slack MCP with stdio/SSE/HTTP, DMs, group DMs and no-admin token auth
Full Telegram user-account MCP via MTProto: read chats, manage groups, send messages
Compare Bluesky Context Server with: