Bluesky Social MCP

Name: Bluesky Social MCP
Author: gwbischof

gwbischof

Get started Repository Website & docs

Lets agents interact with the Bluesky social network through the atproto Python client.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add bluesky-social --env BLUESKY_IDENTIFIER='<BLUESKY_IDENTIFIER>' --env BLUESKY_APP_PASSWORD='<BLUESKY_APP_PASSWORD>' -- uvx --from git+https://github.com/gwbischof/bluesky-social-mcp@v0.1 bluesky-social-mcp

~/.codex/config.toml

[mcp_servers.bluesky-social]
command = "uvx"
args = ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"]
env = { BLUESKY_IDENTIFIER = "<BLUESKY_IDENTIFIER>", BLUESKY_APP_PASSWORD = "<BLUESKY_APP_PASSWORD>" }

# codex mcp add bluesky-social --env BLUESKY_IDENTIFIER='<BLUESKY_IDENTIFIER>' --env BLUESKY_APP_PASSWORD='<BLUESKY_APP_PASSWORD>' -- uvx --from git+https://github.com/gwbischof/bluesky-social-mcp@v0.1 bluesky-social-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1",
        "bluesky-social-mcp"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "bluesky-social": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1",
        "bluesky-social-mcp"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1",
        "bluesky-social-mcp"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1",
        "bluesky-social-mcp"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1",
        "bluesky-social-mcp"
      ],
      "env": {
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
      }
    }
  }
}

Environment variables

BLUESKY_IDENTIFIER
BLUESKY_APP_PASSWORD

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related