cosmos mcp
one graph ยท any agent

One command installs the MCP server, wires Claude Desktop, Claude Code, Cursor, Codex, Zed, Continue into your Cosmos graph, and keeps iMessage, browser history, and calendar syncs moving in the background on macOS.

Install
curl -fsSL https://mcp.polarity-lab.com/install.sh | sh

On macOS this installs the full stack. On linux and windows it installs the MCP server; the Sync app is macOS only right now.

If piping a script into your shell is not your style, read the script first or run it with --dry-run.
Open connectors Full install notes Open repo
What the installer does
  1. Checks for Node 20+. On macOS it can install Node through Homebrew if needed.
  2. Installs @polarity-lab/cosmos-mcp from npm. The package exposes the stdio MCP server and local sync commands.
  3. Drops Cosmos Sync.app into /Applications. The app runs the local daemon at login on macOS.
  4. Registers cosmos-mcp://. The browser can hand a fresh key into your macOS keychain without showing it on screen.
  5. Merges cosmos into every MCP client it finds. Claude Desktop, Claude Code, Cursor, Codex, Zed, Continue. Existing servers stay in place and every edited config gets a backup.
  6. Opens the Cosmos connectors page. Sign in, mint a key, then let the browser hand it to cosmos-mcp.
Flags
curl -fsSL https://mcp.polarity-lab.com/install.sh | sh -s -- --dry-run
curl -fsSL https://mcp.polarity-lab.com/install.sh | sh -s -- --no-app

--dry-run prints every file, command, and config merge before anything changes. --no-app installs only the MCP server and skips the macOS background app.

Sources
iMessage

Reads local Messages history, resolves people through AddressBook, filters junk, and writes real conversation turns into your graph.

Browser

Syncs local browser history with noise filters, so the graph sees useful pages instead of tab churn and OAuth redirects.

Calendar

Reads local Apple Calendar events and attendee context, then lands them as source pages your agents can retrieve later.

Agents

Claude Code, Claude Desktop, Cursor, Codex, Zed, and Continue all read and write through the same key.

Manual path

Install the package, add it to your MCP client, then provision a key from Cosmos.

npm install -g @polarity-lab/cosmos-mcp
claude mcp add cosmos --scope user -- npx -y @polarity-lab/cosmos-mcp
npx -y @polarity-lab/cosmos-mcp provision pmk_xxx

For Claude Desktop and Cursor, the server entry is the same JSON shape under mcpServers.cosmos. For Codex, use a [mcp_servers.cosmos] block in ~/.codex/config.toml.

Why this subdomain exists

why mcp.polarity-lab.com matters

mcp.polarity-lab.com is the stable public doorway for the package. The app lives at cosmos.polarity-lab.com, but registries, npm readers, shell installers, and people checking whether an MCP server is legitimate need one small canonical surface that says what the server is, where it installs from, which domain mints keys, and which metadata crawlers should trust.

Links
View on npm Registry metadata Server card