
Cosmos Mcp
A portable knowledge graph that lives in a `.polarity` file and syncs across every MCP client you use. Instead of letting Claude, Cursor, and ChatGPT each build siloed models of you, this inverts the architecture: one graph, many readers. It exposes eleven tools split between reads (whoami, export, get_graph, ask) and writes (observe, record_event, record_preference, capture_turn, dump, checkin, declare). You can feed it from iMessage, Notion, Obsidian, shell history, or Claude Desktop transcripts. The sync CLIs are local-first and incremental. Provision once with a `pmk_` key, point your clients at the npx command, and observations from any agent land in the same graph. Useful when you want continuity across tools without re-teaching context.
- GitHub stars
- 3
- tools
- 12
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- May 19, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
polarity_whoamiBound user + scopes. Cheap probe.
Bound user + scopes. Cheap probe.
No parameter schema in public metadata yet.
polarity_exportFull personal graph as polarity/v1 JSON.
Full personal graph as polarity/v1 JSON.
No parameter schema in public metadata yet.
polarity_get_graphGraph view, scoped by entity (user, cosmos, polarity).
Graph view, scoped by entity (user, cosmos, polarity).
No parameter schema in public metadata yet.
polarity_askNL question synthesized over the graph.
NL question synthesized over the graph.
No parameter schema in public metadata yet.
polarity_observeFreeform observation. Cosmos extracts.
Freeform observation. Cosmos extracts.
No parameter schema in public metadata yet.
polarity_record_eventSomething happened at a point in time.
Something happened at a point in time.
No parameter schema in public metadata yet.
polarity_record_preferenceA like, dislike, working-style rule.
A like, dislike, working-style rule.
No parameter schema in public metadata yet.
polarity_capture_turnHand a whole user/assistant exchange to cosmos. Pulls every durable observation in one call. Prefer over multiple polarity_observe calls.
Hand a whole user/assistant exchange to cosmos. Pulls every durable observation in one call. Prefer over multiple polarity_observe calls.
No parameter schema in public metadata yet.
polarity_reconstruct_hoursPersist life-hour receipts onto the skill-map sky (per user only). Use from Cursor/Cosmos IDE after substantive work.
Persist life-hour receipts onto the skill-map sky (per user only). Use from Cursor/Cosmos IDE after substantive work.
No parameter schema in public metadata yet.
polarity_dumpLocation-anchored short message.
Location-anchored short message.
No parameter schema in public metadata yet.
polarity_checkinCheck-in at a waypoint. Triggers co-presence detection.
Check-in at a waypoint. Triggers co-presence detection.
No parameter schema in public metadata yet.
polarity_declareDeclare future presence at a waypoint.
Declare future presence at a waypoint.
No parameter schema in public metadata yet.
Sponsors
Configuration
COSMOS_TOKENsecretpmk_ key from https://cosmos.polarity-lab.com/connectors. Optional on macOS once the system keychain is provisioned via `npx -y @polarity-lab/cosmos-mcp provision pmk_...`.
Readme
cosmos-mcp
One exocortex. Every agent.
MCP server for your Cosmos graph.
Every AI you use is building its own private graph of you. Claude has one. ChatGPT has one. Cursor has one. None of them talk to each other, and none of them are yours.
Details
- Repository
- github.com/teampolarity/cosmos-mcp
- Category
- Documents & Knowledge
- Package
@polarity-lab/cosmos-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active