What environment variables do I need?
You must set `BLUESKY_IDENTIFIER` (your Bluesky handle or email) and `BLUESKY_PASSWORD` (your Bluesky app password) in the Claude Desktop config file.
Bluesky MCP Server
@semioz
Basic information
About Bluesky MCP Server
mcp server for bluesky. featured in offical mcp server repo.
Bluesky MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"bluesky-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@semioz/bluesky-mcp",
"--client",
"claude"
]
}
}
}Bluesky MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is Bluesky MCP Server?
The Bluesky MCP Server is a Model Context Protocol server that enables AI assistants (like Claude) to interact with Bluesky via the AT Protocol. It allows users to read and write posts, manage interactions, and view profiles and timelines through MCP-compatible clients.
How to use Bluesky MCP Server?
Install automatically via Smithery (npx -y @smithery/cli install @semioz/bluesky-mcp --client claude) or manually by adding a configuration entry to claude_desktop_config.json with environment variables BLUESKY_IDENTIFIER and BLUESKY_PASSWORD. After setup, the server auto-logs in; you can use the login tool if you need different credentials or if auto-login fails.
Key features of Bluesky MCP Server
- Authenticate with Bluesky using handle/email and app password
- Create text posts with optional image uploads (base64)
- Retrieve single or multiple posts by URI
- Delete your posts
- Like/unlike and repost/unrepost content
- View your profile and timeline (up to 100 posts)
- Automatic link and mention detection in rich text
- MCP compatible – works with Claude Desktop and other MCP clients
Use cases of Bluesky MCP Server
- Let an AI assistant post updates on your Bluesky account
- Automate reading and responding to your timeline
- Manage likes and reposts without opening the Bluesky app
- Fetch and format your timeline for review or summarization
- Integrate Bluesky interactions into chat-based workflows
Frequently asked questions
When should I use the login tool?
The server auto-logs in using environment variables. Use the `login` tool if you haven’t set those variables, want to use different credentials, or auto-login failed.
Can I create posts with images?
Yes. The `create-post` tool accepts an optional `images` array containing base64-encoded image data and the MIME type (e.g., `image/jpeg`).
How do I get my timeline?
Use the `get-timeline` tool with an optional `limit` parameter (maximum 100). The `format-timeline` prompt can then format the returned data with author info, text, engagement metrics, timestamps, and embedded content.
How does authentication work?
Credentials are provided via environment variables or the `login` tool. The server uses the AT Protocol to authenticate with Bluesky; an app password is required, not your main account password.
More Other MCP servers
P
PickFu MCP
PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Codelf
unbugA search tool helps dev to solve the naming things problem.
14.2K
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
39.5K
Blender
ahujasidOpen-source MCP to use Blender with any LLM
23.6K
Comments