laulauland/bluesky-context-server

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.
Prerequisites
- **Runtime**: Either Bun or Node.js v22.6.0+
- A Bluesky account
Setup
1. Get Your Bluesky Credentials
You'll need two pieces of information from your Bluesky account:
BLUESKY_IDENTIFIER
This is your Bluesky handle (username). It can be in either format:
- username.bsky.social (e.g., alice.bsky.social)
- @username.bsky.social (e.g., @alice.bsky.social)
BLUESKY_APP_KEY
This is an App Password, which is different from your regular Bluesky password. To create one:
1. Go to Bluesky Settings
2. Navigate to "Privacy and Security" → "App Passwords"
3. Click "Add App Password"
4. Give it a name (e.g., "MCP Server")
5. Copy the generated password (it looks like xxxx-xxxx-xxxx-xxxx)
⚠️ **Important**: Use the App Password, not your regular account password!
2. Installation
Option A: Installing via Smithery (Recommended)
To install Bluesky Context Server for Claude Desktop automatically via Smithery:
Then add your credentials to the generated configuration.
Option B: Manual Installation
1. Clone or download this repository
2. Configure your Claude Desktop app to use the MCP server:
**Using Bun:**
**Using Node.js:**
3. Restart Claude Desktop
3. Testing the Connection
After setup, you can test the connection by asking Claude something like:
- "Can you get my Bluesky profile?"
- "Show me my recent posts on Bluesky"
- "Search for posts about AI on Bluesky"
Available MCP Tools
This server provides the following tools that Claude can use:
Profile & Account Tools
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 profile info
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 info
Post & Feed Tools
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 personalized feed
bluesky_get_liked_posts
Get posts you've liked.
- **Parameters**:
- limit (optional): Max items to return (default 50, max 100)