io.github.purmemo-ai/purmemo

pūrmemo

Memory for your AI tools. Claude remembers who you are, what you're working on, and what you said last time — across every session, on every platform.

Just want it in ChatGPT or Claude.ai in your browser? Get the Chrome Extension instead.

Install in 30 seconds

1. Paste this into your terminal

Mac or Linux:

curl -fsSL https://app.purmemo.ai/install | sh

Windows (PowerShell):

irm https://app.purmemo.ai/install.ps1 | iex

That's it for installing. The script handles everything — it'll install Node if you don't have it, set up the purmemo command, and tell you when it's done.

2. Type purmemo

purmemo

Your browser opens. Sign in (or create a free account). Close the tab when it says you're done.

3. Restart Claude

Quit and reopen Claude Desktop (or Claude Code). pūrmemo is now connected.

You'll know it worked when your next Claude session opens with a header like:

pūrmemo v15.7.20 · you@example.com · Free · 0 memories

Try saying "save this" at the end of a conversation, or "what was I working on?" at the start of a new one.

If something goes wrong

purmemo command not found? Close and reopen your terminal, then try again. New commands sometimes need a fresh shell.

You see "Failed to read token" or "bad decrypt"? Run:

purmemo --update && purmemo init

This clears any stale credentials and signs you back in. (Fixed in v15.7.20+ — if you're on an older version, this is a one-time thing.)

Anything else? Open an issue at github.com/purmemo-ai/purmemo-mcp/issues — we read every one.

What it does

• Remembers everything — save any conversation, recall it later by typing what you remember about it.
• Knows who you are — your role, your projects, your stack — loaded automatically into every new session.
• Tells you what changed — ask what_changed about a person, project, or thing and get its dated history: what used to be true, what replaced it, and when.
• Works everywhere — Claude Code, Claude Desktop, Cursor, Windsurf, Zed, anything that speaks MCP.

Three slash commands you'll use most:

Other ways to install

I already have Node.js

npm install -g purmemo-mcp && purmemo

Or, run it once without installing globally:

npx purmemo-mcp@latest init

Claude Desktop — hosted (recommended, no setup)

Open Claude Desktop → Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "purmemo": {
      "url": "https://mcp.purmemo.ai/mcp/messages",
      "transport": "streamable-http"
    }
  }
}

Restart Claude Desktop. You'll be prompted to sign in via OAuth on first use.

Claude Desktop — local (advanced)

Get your API key from app.purmemo.ai → Settings → API Keys, then edit:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": { "PURMEMO_API_KEY": "your-api-key-here" }
    }
  }
}

Restart Claude Desktop after saving.

Cursor / Windsurf / Zed

Cursor — edit ~/.cursor/mcp.json:

{ "mcpServers": { "purmemo": { "command": "npx", "args": ["-y", "purmemo-mcp"], "env": { "PURMEMO_API_KEY": "your-api-key" } } } }

Windsurf — edit ~/.codeium/windsurf/mcp_config.json (same shape as above).

Zed — edit ~/.config/zed/settings.json, add under context_servers:

{ "context_servers": { "purmemo": { "command": { "path": "npx", "args": ["-y", "purmemo-mcp"], "env": { "PURMEMO_API_KEY": "your-api-key" } } } } }

Pricing

For developers

Looking for the technical stuff? It's all here:

• Tools listed by default — five: save_conversation, recall_memories, get_memory_details, what_changed, get_user_context. A short list helps the assistant pick the right tool. Env flags add more:
  • PURMEMO_SESSIONS_BETA=1 — adds search_past_sessions (beta): searches the raw transcripts of your past AI sessions for what was actually said or decided. Served by purmemo-next at PURMEMO_READ_BASE_URL, else PURMEMO_SESSIONS_URL, else https://next.purmemo.ai.
  • PURMEMO_ADMIN=1 — adds the admin tools (get_acknowledged_errors, save_investigation_result, get_investigations).
  • PURMEMO_LEGACY_TOOLS=1 — brings back the paused tools (save_artifact, commit, the snapshot tools, list_clusters, discover_related_conversations, run_workflow, list_workflows, sharing, tasks, test results and the rest). Called while paused, they answer with what to use instead.
• Tools, resources, prompts reference — every MCP tool the server can expose, including the paused ones.
• Living document semantics — mode='append' vs mode='replace', chunking behavior, ADR-036/038 details.
• Identity layer — the cognitive fingerprint that loads into every session.
• Architecture decisions (ADRs) — every design decision, with context and trade-offs.
• Source for the install scripts — read before running, if you want.

Links

• Dashboard — view and manage memories
• Chrome Extension — for ChatGPT, Claude.ai, Gemini in browser
• Privacy Policy — encrypted in transit and at rest, never shared
• Support / Issues

License

The MCP connector code in this repo is MIT licensed. The pūrmemo platform, API, and backend are proprietary.