Search posts, profiles, feeds, threads, and trending topics on Bluesky via MCP. STDIO or Streamable HTTP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add bluesky-server-cyanheads --env BLUESKY_APP_PASSWORD='<BLUESKY_APP_PASSWORD>' -- npx -y @cyanheads/bluesky-mcp-server~/.codex/config.toml
[mcp_servers.bluesky-server-cyanheads]
command = "npx"
args = ["-y", "@cyanheads/bluesky-mcp-server"]
env = { BLUESKY_APP_PASSWORD = "<BLUESKY_APP_PASSWORD>" }
# codex mcp add bluesky-server-cyanheads --env BLUESKY_APP_PASSWORD='<BLUESKY_APP_PASSWORD>' -- npx -y @cyanheads/bluesky-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"command": "npx",
"args": [
"-y",
"@cyanheads/bluesky-mcp-server"
],
"env": {
"BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"bluesky-server-cyanheads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/bluesky-mcp-server"
],
"env": {
"BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"command": "npx",
"args": [
"-y",
"@cyanheads/bluesky-mcp-server"
],
"env": {
"BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"command": "npx",
"args": [
"-y",
"@cyanheads/bluesky-mcp-server"
],
"env": {
"BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"command": "npx",
"args": [
"-y",
"@cyanheads/bluesky-mcp-server"
],
"env": {
"BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>"
}
}
}
}Remote
claude mcp add --transport http bluesky-server-cyanheads https://bluesky.caseyjhand.com/mcp~/.codex/config.toml
[mcp_servers.bluesky-server-cyanheads]
url = "https://bluesky.caseyjhand.com/mcp"
# codex mcp add bluesky-server-cyanheads --url https://bluesky.caseyjhand.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"bluesky-server-cyanheads": {
"type": "http",
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"httpUrl": "https://bluesky.caseyjhand.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"bluesky-server-cyanheads": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://bluesky.caseyjhand.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"bluesky-server-cyanheads": {
"url": "https://bluesky.caseyjhand.com/mcp"
}
}
}Environment variables
BLUESKY_APP_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.