Bluesky
Enables AI agents to interact with Bluesky social network through optimized, token-efficient tools for posting, replying, searching, and managing social relationships. Features Windows-compatible implementation with context cleanup to minimize LLM to
What is Bluesky?
Bluesky is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to interact with bluesky social network through optimized, token-efficient tools for posting, replying, searching, and managing social relationships. features windows-compatible impl...
Enables AI agents to interact with Bluesky social network through optimized, token-efficient tools for posting, replying, searching, and managing social relationships. Features Windows-compatible implementation with context cleanup to minimize LLM to
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI agents to interact with Bluesky social network th
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bluesky-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bluesky
The Bluesky MCP Server enables AI assistants to interact with the Bluesky social network via the AT Protocol, exposing 18 token-efficient tools for reading timelines, searching posts and people, browsing follower relationships, liking content, creating posts, and discovering trending topics. It includes Windows-compatible stdio transport and context cleanup to minimize LLM token usage per request. Social media managers, researchers, and developers use it to automate content workflows, analyze social graphs, and post to Bluesky entirely through natural language.
Prerequisites
- Node.js 18+ and npm installed
- A Bluesky account (free at bsky.app)
- A Bluesky App Password generated in Settings > Privacy and Security > App Passwords
- Your Bluesky handle (e.g., yourname.bsky.social) as the identifier
- An MCP-compatible client such as Claude Desktop
Install the server via Smithery CLI
The easiest install path uses the Smithery CLI to install and configure the server automatically for Claude Desktop.
npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claudeGenerate a Bluesky App Password
Log in to bsky.app, go to Settings > Privacy and Security > App Passwords, and create a new App Password. Copy it — you will not be able to see it again. Use this instead of your main account password.
Add the server manually to your MCP client config (alternative)
If you prefer manual configuration, add the server entry directly to claude_desktop_config.json with your Bluesky credentials as environment variables.
{
"mcpServers": {
"bluesky": {
"command": "npx",
"args": ["-y", "bluesky-mcp-server"],
"env": {
"BLUESKY_IDENTIFIER": "yourname.bsky.social",
"BLUESKY_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
"BLUESKY_SERVICE_URL": "https://bsky.social"
}
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop to pick up the new server configuration. The 18 Bluesky tools will now be available in your conversations.
Verify by fetching your timeline
Ask Claude to fetch your Bluesky timeline. A successful response with recent posts confirms authentication is working.
Bluesky Examples
Client configuration
Manual claude_desktop_config.json entry for the Bluesky MCP server using the three required environment variables.
{
"mcpServers": {
"bluesky": {
"command": "npx",
"args": ["-y", "bluesky-mcp-server"],
"env": {
"BLUESKY_IDENTIFIER": "yourname.bsky.social",
"BLUESKY_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
"BLUESKY_SERVICE_URL": "https://bsky.social"
}
}
}
}Prompts to try
Example prompts using the 18 tools across timeline reading, discovery, and publishing.
- "Show me the latest posts from my Bluesky timeline."
- "Search for posts about #opensource and summarize the top 5 results."
- "Find people who follow me but whom I don't follow back."
- "Write a short post announcing my new project and post it to Bluesky."
- "What are the trending topics on Bluesky right now?"Troubleshooting Bluesky
Authentication error: Invalid identifier or password
Make sure BLUESKY_IDENTIFIER is your full handle including the domain (e.g., alice.bsky.social, not just alice). Use an App Password, not your main account password. Regenerate the App Password in Bluesky Settings if needed.
create-post tool fails or posts do not appear on Bluesky
Confirm your App Password has write permissions. Some App Passwords can be scoped to read-only. Create a new App Password without restrictions if posting is blocked.
Server crashes on Windows with stdio transport errors
The server includes a Windows-compatible implementation. Ensure you are using Node.js 18+ on Windows and running npx without a shell wrapper. If issues persist, check the Bluesky MCP GitHub issues for Windows-specific patches.
Frequently Asked Questions about Bluesky
What is Bluesky?
Bluesky is a Model Context Protocol (MCP) server that enables ai agents to interact with bluesky social network through optimized, token-efficient tools for posting, replying, searching, and managing social relationships. features windows-compatible implementation with context cleanup to minimize llm to It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bluesky?
Follow the installation instructions on the Bluesky GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Bluesky?
Bluesky works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bluesky free to use?
Yes, Bluesky is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Bluesky Alternatives — Similar Communication Servers
Looking for alternatives to Bluesky? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bluesky in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bluesky?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.