bluesky_get_profileLABSCO SUMMARY
Your feed, readable by something that can summarise it.
It puts the timeline, profiles and the follow graph within reach of an assistant, which turns "what did I miss today" into a question with an answer rather than a scroll.
What it is
A read bridge to Bluesky, signed in as you with an app password. It runs locally and every call is a live read against your account.
What you get
- Your own timeline as it stands — the feed you would see on opening the app
- A profile by handle, yours or anyone else's
- Posts fetched for the accounts or threads you point it at
- The follower list for an account, and the accounts it follows, so the graph is readable rather than scrollable
Requirements
Bun, or Node.js v22.6.0+. A Bluesky account and an App Password created under Settings → Privacy and Security: it signs in as you with your handle and that app password, never your account password.
Setup effort
Follow the published steps — Clone or download this repository
USE CASES
01
Catching up on what you missed
Read the timeline as it stands and get the shape of it back — what the day was about — instead of scrolling to the last post you remember.
02
Working out who someone is before you reply
Their profile and their recent posts, together, so the reply is written with context.
03
Understanding a corner of the network
Read who an account follows and who follows it back — the overlap is usually the community you were trying to find.
04
Pulling a thread into a document
Fetch the posts directly rather than copying them out of the app, and hand them to whatever you are drafting.
8 tools
Listed in project docs. Your client may show a different list.
bluesky_get_followsbluesky_get_followersbluesky_get_postsbluesky_get_personal_feedbluesky_get_liked_postsbluesky_search_postsbluesky_search_profilesBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation. Every tool only reads; it cannot post, reply, like, follow or delete.
Requires
- BLUESKY_APP_KEY in your environment
- BLUESKY_IDENTIFIER in your environment
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
Clone or download this repository
Configure your Claude Desktop app to use the MCP server (add the mcpServers block below)
Restart Claude Desktop
MCP Clients
Claude Desktop — Bun
CLAUDE DESKTOP — BUN · JSON
{
"mcpServers": {
"bluesky": {
"command": "/Users/<YOUR_USERNAME>/.bun/bin/bun",
"args": [
"<YOUR_PATH_TO_BLUESKY_CONTEXT_SERVER>/packages/server/bin/index.ts"
],
"env": {
"BLUESKY_APP_KEY": "<YOUR_BLUESKY_APP_KEY>",
"BLUESKY_IDENTIFIER": "<YOUR_HANDLE>.bsky.social"
}
}
}
}Claude Desktop — Node.js
CLAUDE DESKTOP — NODE.JS · JSON
{
"mcpServers": {
"bluesky": {
"command": "node",
"args": [
"--experimental-strip-types",
"<YOUR_PATH_TO_BLUESKY_CONTEXT_SERVER>/packages/server/bin/index.ts"
],
"env": {
"BLUESKY_APP_KEY": "<YOUR_BLUESKY_APP_KEY>",
"BLUESKY_IDENTIFIER": "<YOUR_HANDLE>.bsky.social"
}
}
}
}
