The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Purmemo listing page.
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.
Mac or Linux:
Windows (PowerShell):
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.
purmemoYour browser opens. Sign in (or create a free account). Close the tab when it says you're done.
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:
Try saying "save this" at the end of a conversation, or "what was I working on?" at the start of a new one.
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:
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.
Three slash commands you'll use most:
| You type | What happens |
|---|---|
/save | Saves this conversation. Use the same title later → updates the same memory. |
/recall <topic> | Search your memories in plain English. |
/context | At the start of a session — loads who you are and what you were last working on. |
Or, run it once without installing globally:
Open Claude Desktop → Settings → Developer → Edit Config and add:
Restart Claude Desktop. You'll be prompted to sign in via OAuth on first use.
Get your API key from app.purmemo.ai → Settings → API Keys, then edit:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonRestart Claude Desktop after saving.
Cursor — edit ~/.cursor/mcp.json:
Windsurf — edit ~/.codeium/windsurf/mcp_config.json (same shape as above).
Zed — edit ~/.config/zed/settings.json, add under context_servers:
| Plan | Price | Recalls | Saves |
|---|---|---|---|
| Free | $0 | 50/month | Unlimited |
| Pro | $19/month | Unlimited | Unlimited |
Looking for the technical stuff? It's all here:
save_conversation, recall_memories, commit, snapshot, run_workflow, etc.)mode='append' vs mode='replace', chunking behavior, ADR-036/038 details.The MCP connector code in this repo is MIT licensed. The pūrmemo platform, API, and backend are proprietary.