bluesky

The Bluesky MCP Server provides an interface to act on your Bluesky account through the MCP (Model Context Protocol) framework. It supports authenticating with Bluesky, creating text posts (with optional image uploads), retrieving single or multiple posts, and managing interactions such as liking, unliking, reposting, and unreposting. You can also fetch your profile and timeline data. After configuring the server, use the provided MCP tools to perform these actions programmatically, with credentials optionally supplied via environment variables for auto-login on startup. The tools and prompts are designed to integrate with Claude Desktop or other MCP-compatible clients, enabling seamless post generation and engagement from AI workflows.

Prerequisites:

• Node.js and npm or npx available on your system
• Access to install MCP servers (e.g., via Smithery or manual configuration)
• Bluesky account and app password if using environment-based authentication

Installation steps:

1. Install via Smithery (automatic): npx -y @smithery/cli install @semioz/bluesky-mcp --client claude

2. Manual installation (recommended for direct MCP integration):

   • Ensure your Claude for Desktop configuration is accessible at: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Add the bluesky-mcp server configuration:

     { "mcpServers": { "bluesky-mcp": { "command": "npx", "args": ["-y", "@semihberkay/bluesky-mcp"], "env": { "BLUESKY_IDENTIFIER": "your.handle.bsky.social", "BLUESKY_PASSWORD": "your-app-password" } } } }

   • Save the file and restart Claude Desktop to load the MCP server.

3. Verify installation:

   • Ensure the bluesky-mcp server appears in your MCP client list.
   • Test authentication by running a sample login or by performing a basic tool action that requires credentials.

Tips and considerations:

• The server can auto-login using BLUESKY_IDENTIFIER and BLUESKY_PASSWORD from environment variables at startup. Use the login tool to override credentials if needed.
• If you change credentials, update the environment variables or re-run the login flow.
• Available tools include creating posts (with optional images via Base64 data), fetching posts, liking/unliking, reposting, and fetching timelines or profiles.
• For image uploads, supply images as an array with data (Base64) and encoding (MIME type), e.g., image/jpeg.
• If you encounter rate limits or authentication failures, ensure app passwords are valid and that your Bluesky account supports API-based interactions via the AT Protocol.
• This MCP server is designed to work with Claude and other MCP-compatible clients.