Purmemo README

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

npm install -g purmemo-mcp && purmemo

npx purmemo-mcp@latest init

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

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

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

{ "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.
• Several accounts on one machine (e.g. personal and work, each connected with purmemo-mcp-setup add). The server still starts on your active account, and that stays the default for every call, hook and auto-capture. When two or more accounts are signed in locally, the core tools gain an optional account argument (a choice among those signed-in accounts only; anything else is refused before any network call) and transfer_memory is listed, which moves one memory between your accounts. Calls on a non-default account are labelled with the account and logged, without content or keys, to ~/.purmemo/account-audit.jsonl. Programs use the same boundary through purmemo-ops (accounts, whoami, save, recall, transfer), which always requires an explicit account. Hosted (remote) mode never offers it; PURMEMO_MULTI_ACCOUNT=0 turns it off. See ADR-040.
• 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.