Purmemo MCP Server

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.
• 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

Or, run it once without installing globally:

npx purmemo-mcp@latest init

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.

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 — 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, resources, prompts reference — every MCP tool the server exposes (save_conversation, recall_memories, commit, snapshot, run_workflow, etc.)
• 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.