Cosmos MCP Server

by teampolarityio.github.teampolarity/cosmos-mcpv0.7.1

Portable personal knowledge graph shared across AI clients, with sources like iMessage, browser history, calendar, shell history, Notion and Obsidian.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained45d ago

Install Cosmos MCP server

claude mcp add cosmos -e COSMOS_TOKEN='<cosmos-token>' -- npx -y @polarity-lab/cosmos-mcp

{
  "mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": [
        "-y",
        "@polarity-lab/cosmos-mcp"
      ],
      "env": {
        "COSMOS_TOKEN": "<cosmos-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": [
        "-y",
        "@polarity-lab/cosmos-mcp"
      ],
      "env": {
        "COSMOS_TOKEN": "<cosmos-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "cosmos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@polarity-lab/cosmos-mcp"
      ],
      "env": {
        "COSMOS_TOKEN": "<cosmos-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": [
        "-y",
        "@polarity-lab/cosmos-mcp"
      ],
      "env": {
        "COSMOS_TOKEN": "<cosmos-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
COSMOS_TOKEN	—	yes	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_...`.

Freshness

Maintained — last maintenance signal 45d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-25 · 45d ago · GitHub
Latest release
2026-07-03 · 3mo ago · GitHub · v0.9.29
Package published
no data · npm/PyPI
Registry entry updated
2026-05-19 · 5mo ago · official registry · v0.7.1

FAQ

›How do I install the Cosmos MCP server in Claude Code?

Run: claude mcp add cosmos -e COSMOS_TOKEN='<cosmos-token>' -- npx -y @polarity-lab/cosmos-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Cosmos require an API key?

Yes. It expects COSMOS_TOKEN, of which 1 is a secret.

›Can I use Cosmos as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Cosmos in the official MCP registry?

Yes, as io.github.teampolarity/cosmos-mcp.