Bluesky MCP Server
@semioz
About Bluesky MCP Server
mcp server for bluesky. featured in offical mcp server repo.
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"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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
FAQ from Bluesky MCP Server
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.
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.
Frequently asked questions
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.
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.
Basic information
More Other MCP servers
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
EverArt
modelcontextprotocolModel Context Protocol Servers
Codelf
unbugA search tool helps dev to solve the naming things problem.
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Comments