mcpField
M
mcp-server-bluesky

mcp-server-bluesky

Local
github.com/morinokamiSocial Media10Updated 81w ago
Repository

About mcp-server-bluesky

mcp-server-bluesky is an MCP server for working with Bluesky. It is suited to users managing accounts and content through an MCP client, with tools for profiles, follows, posts, timelines, likes, and reposts.

Key features

  1. 01Read profiles and followers
  2. 02Follow and unfollow accounts
  3. 03Search, publish, and delete posts
  4. 04View timelines and post threads
  5. 05Like, repost, and undo actions

Use cases

  1. 01Search Bluesky posts
  2. 02Publish or remove a post
  3. 03Check followers and follow lists
  4. 04Browse timelines and inspect post threads

MCP support

The server provides MCP clients with tools for Bluesky accounts, follows, posts, timelines, likes, and reposts. It requires a username and password; the PDS URL is optional and defaults to https://bsky.social.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-bluesky"
      ],
      "env": {
        "BLUESKY_USERNAME": "<BLUESKY_USERNAME>",
        "BLUESKY_PASSWORD": "<BLUESKY_PASSWORD>",
        "BLUESKY_PDS_URL": "<BLUESKY_PDS_URL>"
      }
    }
  }
}
Run commandnpx -y mcp-server-bluesky
Environment variables to set
BLUESKY_USERNAME
BLUESKY_PASSWORDSecret
BLUESKY_PDS_URL

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-bluesky

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-server-bluesky

MCP server for Bluesky.

Usage with Claude Desktop

{
  "mcpServers": {
    "bluesky": {
      "command": "npx",
      "args": ["-y", "mcp-server-bluesky"],
      "env": {
        "BLUESKY_USERNAME": "username",
        "BLUESKY_PASSWORD": "password",
        "BLUESKY_PDS_URL": "https://bsky.social"
      }
    }
  }
}

The BLUESKY_PDS_URL is optional and defaults to https://bsky.social if not specified.

Tools

  • bluesky_get_profile
  • bluesky_follow
  • bluesky_delete_follow
  • bluesky_get_follows
  • bluesky_get_followers
  • bluesky_search_posts
  • bluesky_post
  • bluesky_delete_post
  • bluesky_repost
  • bluesky_delete_repost
  • bluesky_get_timeline
  • bluesky_get_post_thread
  • bluesky_get_likes
  • bluesky_like
  • bluesky_delete_like

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.