Borrowing it
Nothing to install: this file belongs to adamkwhite/universal-memory-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/adamkwhite/universal-memory-mcp/main/CLAUDE.mdgit clone --depth 1 https://github.com/adamkwhite/universal-memory-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/adamkwhite/universal-memory-mcp/claude-md)<a href="https://agentmods.dev/instructions/adamkwhite/universal-memory-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/adamkwhite/universal-memory-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/adamkwhite/universal-memory-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/adamkwhite/universal-memory-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.13026 | $0.13026 |
| Opus 5.5 | $0.05210 | $0.05210 |
| Sonnet 5.5 | $0.02605 | $0.02605 |
| Haiku 4.5 | $0.01303 | $0.01303 |
Grade D, and why
universal-memory-mcp CLAUDE.md scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
`curl -s "https://sonarcloud.io/api/issues/search?componentKeys=adamkwhite_universal-memory-mcp&resolved=false" | python3 -c "import json,sys; print(json.load(sys.stdin)['total'])"`. Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
and Codex's `~/.codex/config.toml` — dry-run by default, `--apply` writes after a timestamped Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
`curl -s "https://sonarcloud.io/api/issues/search?componentKeys=adamkwhite_universal-memory-mcp&resolved=false" | python3 -c "import json,sys; print(json.load(sys.stdin)['total'])"`. How it starts
The opening of the file, as written. The whole thing — 904 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Universal Memory MCP - Universal AI Memory System
Rule for editing this file: never restate an enumeration. MCP tool inventories, test counts,
required-check lists, file:line citations, table/column rosters — name the code or command that is
true by construction (grep '@mcp.tool()' -A2 src/universal_memory_mcp/server_fastmcp.py, pytest -q | tail -1,
gh api repos/adamkwhite/universal-memory-mcp/rulesets/5957219) and let the reader run it. A prose
copy of an enumerable fact rots while the thing it copies moves, and it rots while still reading as
authoritative — which is worse than being absent, because nobody re-checks a confident sentence.
Adopted from job-agent's CLAUDE.md:7, where it is measurably working: a drift sweep of that file
on 2026-08-16 found four stale claims and zero enumeration drift.
It cannot cover everything, and knowing where it stops matters. A behavioural claim — "this script
aborts on failure", "that context manager doesn't close the connection" — has no pointer-to-code
form. You either assert it or lose the knowledge. Those are what the /EndSession CLAUDE.md drift
sweep exists for. Prevention for enumerable facts, sweep for behavioural ones.
Project Overview
Claude Memory MCP is a universal conversation memory system that provides persistent storage and intelligent search across multiple AI platforms. Originally designed for Claude, it now supports ChatGPT, Cursor AI, and custom formats through an extensible architecture.
Current Status (August 20, 2026)
Branch: main
Recent Work: SonarCloud debt cleared to zero (#232, via #238–#240/#244/#247) and
scripts/switch_mcp_config.py added to repoint MCP configs at the published console script
(#245/#246) — the #225 package move broke every config that launched the server as a loose file.
Before that: published to PyPI as universal-memory-mcp (#230, tag v0.1.0; now 0.1.2),
which required #225 — the wheel had been shipping without the application. See todos.md.
Test Coverage: run pytest -q | tail -1 for the local count and read the Tests (Windows) job for the CI one — both were restated here and both had already drifted. Windows carries a small number of deliberate POSIX-only skips (see the quality-gate section). Coverage: SonarCloud is authoritative, not a local .coverage file; ≥80% required on new code.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 13d ago Changed · -2 lines · -42 tokens per session b1d1f8a5076c
- 2mo ago First seen · 906 lines · 13,068 tokens per session scan D 32b859be8933
universal-memory-mcp CLAUDE.md is an instructions file published in the GitHub repository adamkwhite/universal-memory-mcp (3 stars, last pushed 4d ago), licensed MIT. It adds 13,026 tokens to every session, about $0.0521 per session on Opus 5.5. A static security scan graded it D with 3 findings (downloads and executes remote code, reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
universal-memory-mcp CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| universal-memory-mcp CLAUDE.mdadamkwhite/universal-memory-mcp | Instructions file | 3 | 4d ago | MIT | D | 13,026 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |