Bluesky

This Bluesky MCP Server lets you expose Bluesky actions and data as MCP endpoints so your clients can perform profile lookups, posting, liking, and timeline interactions through a consistent MCP interface. It handles authentication and routes calls to Bluesky, enabling integration with other MCP-enabled tools and clients.

How to use

You connect your MCP client to the Bluesky MCP Server using its stdio-based runtime. Provide your Bluesky credentials when starting the server, and you can perform common actions such as getting profiles, following users, posting, liking, reposting, and reading timelines and threads. The server exposes a set of tools you can invoke from your MCP client to interact with Bluesky data and actions.

How to install

Prerequisites: you need Node.js and npm installed on your system. You also need access to Bluesky credentials to authorize the server.

1. Ensure Node.js and npm are installed. Check versions with node -v and npm -v. Install from https://nodejs.org if needed.

2. Create your MCP server configuration to run Bluesky via npx. You can copy the following snippet into your MCP configuration file.

{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": ["-y", "mcp-server-bluesky"],
      "env": {
        "BLUESKY_USERNAME": "username",
        "BLUESKY_PASSWORD": "password"
      }
    }
  }
}

Additional setup notes

Placeholders in the config indicate where you supply real Bluesky credentials. When you run an MCP client that uses this server, supply your BLUESKY_USERNAME and BLUESKY_PASSWORD values securely. Do not commit credentials to source control. If you need to rotate credentials, update the environment variables in your runtime configuration and restart the server.

Notes on available actions

This server provides a set of tools to interact with Bluesky, including getting profiles, following/unfollowing, retrieving follows and followers, searching posts, creating and deleting posts, reposting, liking, timeline access, and reading post threads and likes. Use these tools from your MCP client to drive Bluesky activities without directly handling Bluesky API details.

Security and access

Treat Bluesky credentials as sensitive data. Restrict access to your MCP client configuration and environment where the Bluesky credentials are defined. Rotate credentials periodically and monitor access to the server.

Available tools

bluesky_get_profile

Fetch a Bluesky user profile by handle or ID.

bluesky_follow

Follow a Bluesky user.

bluesky_delete_follow

Unfollow a Bluesky user.

bluesky_get_follows

List users you are following.

bluesky_get_followers

List users who follow you.

bluesky_search_posts

Search posts matching a query.

bluesky_post

Create a new Bluesky post.

bluesky_delete_post

Delete a Bluesky post.

bluesky_repost

Repost a Bluesky post.

bluesky_delete_repost

Remove a Bluesky repost.

bluesky_get_timeline

Retrieve the timeline for a user.

bluesky_get_post_thread

Fetch the thread for a specific post.

bluesky_get_likes

Get users who liked a post.

bluesky_like

Like a Bluesky post.

bluesky_delete_like

Remove a like from a post.