Bluesky MCP Server logo

Bluesky MCP Server

by semioz

A Model Context Protocol (MCP) server for Bluesky that allows you to post on your behalf using the AT Protocol. It provides tools for authentication, posting, interacting with posts, and managing your profile and timeline.

View on GitHub

Last updated: N/A

What is Bluesky MCP Server?

The Bluesky MCP Server is a tool that enables applications like Claude to interact with the Bluesky social network on your behalf. It acts as a bridge, translating commands into AT Protocol requests for posting, liking, reposting, and managing your profile.

How to use Bluesky MCP Server?

The server can be installed either via Smithery or manually. After installation, configure your application (e.g., Claude) with the server's command and environment variables (Bluesky handle/email and app password). Then, use the available MCP tools by sending commands with appropriate parameters for actions like creating posts, liking, or fetching timeline data.

Key features of Bluesky MCP Server

  • Authentication with Bluesky

  • Create text posts with image uploads

  • Get user profile and timeline

  • Like/Unlike posts

  • Repost/Unrepost

  • Rich text support with automatic link and mention detection

  • MCP compatible for use with Claude

Use cases of Bluesky MCP Server

  • Automated posting to Bluesky from other applications

  • Integrating Bluesky interactions into workflows

  • Building custom Bluesky clients or bots

  • Managing your Bluesky presence programmatically

FAQ from Bluesky MCP Server

What is an app password and where do I get it?

An app password is a unique password generated specifically for applications to access your Bluesky account. You can generate one in your Bluesky account settings under 'App Passwords'.

How do I set the environment variables?

The environment variables (BLUESKY_IDENTIFIER and BLUESKY_PASSWORD) need to be set in the configuration file of the application using the MCP server, such as Claude's claude_desktop_config.json.

What happens if auto-login fails?

If auto-login fails, use the login tool with your Bluesky handle/email and app password to authenticate manually.

What image formats are supported for image uploads?

The server expects images to be base64 encoded with a corresponding MIME type (e.g., image/jpeg).

What is the maximum number of posts I can fetch from the timeline?

The get-timeline tool allows you to fetch up to 100 posts at a time.