How do I install the bluesky mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `BLUESKY_APP_KEY`, `BLUESKY_IDENTIFIER` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Bluesky MCP Server

integrates with Bluesky API to query and search feeds and posts.

Local serverstdioTypeScript

What is the Bluesky MCP Server?

Bluesky mcp server lets Claude, Cursor and other MCP clients work with Bluesky directly. integrates with Bluesky API to query and search feeds and posts.

What Bluesky does

A Model Context Protocol (MCP) server that enables MCP clients like Claude Desktop to interact with Bluesky. Query your profile, search posts, get your timeline, and more directly from your AI assistant.

Requirements

Runtime: Either Bun or Node.js v22.6.0+ - A Bluesky account

Practical notes

Written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
bluesky_get_profile	Get your Bluesky profile information including display name, bio, follower count, etc. - Parameters: None - Returns: Complete profile data
bluesky_get_follows	Get a list of accounts you follow. - Parameters: - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns: List of followed accounts with profil
bluesky_get_followers	Get a list of accounts following you. - Parameters: - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns: List of followers with profile inf
bluesky_get_posts	Get your recent posts. - Parameters: - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns: Your recent posts with engagement data
bluesky_get_personal_feed	Get your personalized Bluesky timeline/feed. - Parameters: - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns: Posts from your personalize
bluesky_get_liked_posts	Get posts you've liked. - Parameters: - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns: Posts you've liked
bluesky_search_posts	Search for posts across Bluesky. - Parameters: - query (required): Search query string - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns:
bluesky_search_profiles	Search for Bluesky user profiles. - Parameters: - query (required): Search query string - limit (optional): Max items to return (default 50, max 100) - cursor (optional): Pagination cursor for next page - Returns

Configuration

Runtime: Either Bun or Node.js v22.6.0+ - A Bluesky account

Variable	Description	Required
BLUESKY_APP_KEY	Credential the server authenticates with.	Yes
BLUESKY_IDENTIFIER	Configuration value read at startup.	Optional

Example prompts to try

“Use Bluesky to BLUESKY IDENTIFIER.”
“Use Bluesky to BLUESKY APP KEY.”
“Use Bluesky to bluesky get profile.”

Frequently asked questions

integrates with Bluesky API to query and search feeds and posts. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.