teampolarity avatar

Cosmos Mcp

teampolarity/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 tools

Public 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_TOKENsecret

pmk_ 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

Polarity

cosmos-mcp

One exocortex. Every agent.
MCP server for your Cosmos graph.

npm license site glama


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.


View the full README on GitHub

Details

Repository
github.com/teampolarity/cosmos-mcp
Category
Documents & Knowledge
Package
@polarity-lab/cosmos-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Documents & Knowledge MCP servers

View all
1adelaidasofia avatarFastMCP server for surgical queries against a vault knowledge graph (NetworkX noadelaidasofia/graph-query-mcpFastMCP server for surgical queries against a vault knowledge graph (NetworkX node-link JSON).…2stars
2sofya-co avatarSofyasofya-co/sofya-mcpWeb search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.2stars
3emcd avatarnb-mcp-serveremcd/nb-mcp-serverMCP server wrapping the nb CLI for LLM-friendly note-taking0stars
4calypso-so avatarCalypso Multimodal RAG MCPcalypso-so/calypso-mcp-serverCalypso multimodal RAG for grounded answers from docs, images, charts, and knowledge.2stars
5ddmanyes avatarsecond-brain MCPddmanyes/second-brain-mcpSelf-maintaining knowledge vault: figure-level search, auto-wikilinks, and memory compression.2stars
6gogogadgetbytes avatarSmart Connectionsgogogadgetbytes/smart-connections-mcpMCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.2stars