{
  "markdown": "# pūrmemo\n\n[![npm version](https://badge.fury.io/js/purmemo-mcp.svg)](https://www.npmjs.com/package/purmemo-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/purmemo-mcp.svg)](https://www.npmjs.com/package/purmemo-mcp)\n[![Tests](https://github.com/purmemo-ai/purmemo-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/purmemo-ai/purmemo-mcp/actions/workflows/test.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**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.\n\n> Just want it in ChatGPT or Claude.ai in your browser? Get the [Chrome Extension](https://chromewebstore.google.com/detail/p%C5%ABrmemo/moemdiomegehfjgjahfgjlbmikhnbhca) instead.\n\n---\n\n## Install in 30 seconds\n\n### 1. Paste this into your terminal\n\n**Mac or Linux:**\n```bash\ncurl -fsSL https://app.purmemo.ai/install | sh\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https://app.purmemo.ai/install.ps1 | iex\n```\n\nThat'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.\n\n### 2. Type `purmemo`\n\n```bash\npurmemo\n```\n\nYour browser opens. Sign in (or create a free account). Close the tab when it says you're done.\n\n### 3. Restart Claude\n\nQuit and reopen Claude Desktop (or Claude Code). pūrmemo is now connected.\n\n**You'll know it worked** when your next Claude session opens with a header like:\n\n```\npūrmemo v15.7.20 · you@example.com · Free · 0 memories\n```\n\nTry saying \"save this\" at the end of a conversation, or \"what was I working on?\" at the start of a new one.\n\n---\n\n## If something goes wrong\n\n**`purmemo` command not found?** Close and reopen your terminal, then try again. New commands sometimes need a fresh shell.\n\n**You see \"Failed to read token\" or \"bad decrypt\"?** Run:\n```bash\npurmemo --update && purmemo init\n```\nThis 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.)\n\n**Anything else?** Open an issue at [github.com/purmemo-ai/purmemo-mcp/issues](https://github.com/purmemo-ai/purmemo-mcp/issues) — we read every one.\n\n---\n\n## What it does\n\n- **Remembers everything** — save any conversation, recall it later by typing what you remember about it.\n- **Knows who you are** — your role, your projects, your stack — loaded automatically into every new session.\n- **Works everywhere** — Claude Code, Claude Desktop, Cursor, Windsurf, Zed, anything that speaks MCP.\n\nThree slash commands you'll use most:\n\n| You type | What happens |\n|----------|-------------|\n| `/save` | Saves this conversation. Use the same title later → updates the same memory. |\n| `/recall <topic>` | Search your memories in plain English. |\n| `/context` | At the start of a session — loads who you are and what you were last working on. |\n\n---\n\n## Other ways to install\n\n<details>\n<summary><b>I already have Node.js</b></summary>\n\n```bash\nnpm install -g purmemo-mcp && purmemo\n```\n\nOr, run it once without installing globally:\n\n```bash\nnpx purmemo-mcp@latest init\n```\n\n</details>\n\n<details>\n<summary><b>Claude Desktop — hosted (recommended, no setup)</b></summary>\n\nOpen Claude Desktop → Settings → Developer → Edit Config and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"purmemo\": {\n      \"url\": \"https://mcp.purmemo.ai/mcp/messages\",\n      \"transport\": \"streamable-http\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You'll be prompted to sign in via OAuth on first use.\n\n</details>\n\n<details>\n<summary><b>Claude Desktop — local (advanced)</b></summary>\n\nGet your API key from [app.purmemo.ai](https://app.purmemo.ai) → Settings → API Keys, then edit:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"purmemo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"purmemo-mcp\"],\n      \"env\": { \"PURMEMO_API_KEY\": \"your-api-key-here\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n</details>\n\n<details>\n<summary><b>Cursor / Windsurf / Zed</b></summary>\n\n**Cursor** — edit `~/.cursor/mcp.json`:\n```json\n{ \"mcpServers\": { \"purmemo\": { \"command\": \"npx\", \"args\": [\"-y\", \"purmemo-mcp\"], \"env\": { \"PURMEMO_API_KEY\": \"your-api-key\" } } } }\n```\n\n**Windsurf** — edit `~/.codeium/windsurf/mcp_config.json` (same shape as above).\n\n**Zed** — edit `~/.config/zed/settings.json`, add under `context_servers`:\n```json\n{ \"context_servers\": { \"purmemo\": { \"command\": { \"path\": \"npx\", \"args\": [\"-y\", \"purmemo-mcp\"], \"env\": { \"PURMEMO_API_KEY\": \"your-api-key\" } } } } }\n```\n\n</details>\n\n---\n\n## Pricing\n\n| Plan | Price | Recalls | Saves |\n|------|-------|---------|-------|\n| Free | $0 | 50/month | Unlimited |\n| Pro | $19/month | Unlimited | Unlimited |\n\n---\n\n## For developers\n\nLooking for the technical stuff? It's all here:\n\n- **[Tools, resources, prompts reference](docs/REFERENCE.md)** — every MCP tool the server exposes (`save_conversation`, `recall_memories`, `commit`, `snapshot`, `run_workflow`, etc.)\n- **[Living document semantics](docs/LIVING_DOCUMENTS.md)** — `mode='append'` vs `mode='replace'`, chunking behavior, ADR-036/038 details.\n- **[Identity layer](docs/IDENTITY.md)** — the cognitive fingerprint that loads into every session.\n- **[Architecture decisions (ADRs)](docs/adr/)** — every design decision, with context and trade-offs.\n- **[Source for the install scripts](scripts/)** — read before running, if you want.\n\n---\n\n## Links\n\n- **[Dashboard](https://app.purmemo.ai)** — view and manage memories\n- **[Chrome Extension](https://chromewebstore.google.com/detail/p%C5%ABrmemo/moemdiomegehfjgjahfgjlbmikhnbhca)** — for ChatGPT, Claude.ai, Gemini in browser\n- **[Privacy Policy](https://purmemo.ai/privacy)** — encrypted in transit and at rest, never shared\n- **[Support / Issues](https://github.com/purmemo-ai/purmemo-mcp/issues)**\n\n---\n\n## License\n\nThe MCP connector code in this repo is [MIT licensed](./LICENSE). The pūrmemo platform, API, and backend are proprietary.\n",
  "bytes": 6119,
  "sha": "d2f8de54a40841248137067cc9ccf5e90d5cf996169438db56b3f48bb114110a",
  "repo_slug": "purmemo-ai/purmemo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_purmemo_ai_purmemo_18d40e3e/readme"
}