Toon Memory MCP Server

Offline persistent memory for AI coding agents — 37 tools, 80% fewer calls, no LLM

Local serverstdioTypeScript

What is the Toon Memory MCP Server?

Offline persistent memory for AI coding agents — 37 tools, 80% fewer calls, no LLM

What the server does

Ever had that feeling where your AI agent forgets everything from yesterday's session? You explain the same architecture decision for the third time, and it still suggests the approach you already rejected?

  • MCP Resources — — Read memory as context without tool invocations, including a System Primer (auto-generated knowledge map)
  • 15 agents supported — — OpenCode, VS Code, Claude Code, Cursor, Windsurf, Cline, Continue, Codex CLI, Gemini CLI, Zed, Antigravity, Aider, KiloCode, OpenClaw, Kiro
  • Interactive installer — — Select which agents to configure from a menu
  • SessionStart hooks — — Auto-reminders for Claude Code, Codex CLI, Gemini CLI, Antigravity
  • TOON format — — 22% fewer tokens than JSON (measured), better LLM comprehension
  • Per-project memory — — Each project gets its own memory file

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
memory_rememberSave a decision, pattern, bug, knowledge, or warning (negative "do NOT do this" memory, recalled with a boost) — optional TTL, auto-tag inference, links to buil
memory_recallSearch memory (use BEFORE reading files, filters expired TTL). mode: "graph" expands a relationship-aware subgraph for higher precision. budget: "tiny"
memory_smart_recallUnified recall: BM25 + graph + decay + quality in one call. sessionBias boosts entries from the current git branch. explain: true appends per-entry reasons, bud
memory_forgetLifecycle ops by key or id: action: "soft" (default) marks obsolete, "hard" permanently removes, "restore" brings back to active, "supersede" retires it with a
memory_statsView memory state (including TTL stats, quality distribution, origin/status breakdown, cold memories below quality/access thresholds, and hit rate / duplicate /
memory_summarySave/retrieve file summaries
memory_archiveArchive old entries (>30 days) and expired TTL entries
memory_diffShow changes since a date (24h, 7d, or exact date)
memory_suggestFind related entries for a given context
memory_encryptEnable AES-256-GCM encryption
memory_decryptDisable encryption
memory_backupCreate timestamped backup of memory file (auto-prunes to 10 most recent)
memory_capturedList activity auto-captured by hooks (opt-in) or clear the log
memory_checkpointSession checkpoint: creates a snapshot of current memory state with 7d TTL. Useful for rollback reference during long sessions
memory_consolidateCleanup ops, deterministic (no LLM): mode: "identical" (default) dedupes identical-content entries, "similar" merges near-duplicates (Jaccard >50%), "low-qualit
memory_sessionsShow active agent sessions (branch, files, last-seen) and soft conflicts for parallel work
memory_compressLLM-powered two-step compression: summarize + overwrite. Uses anthropic/openai CLI if available, otherwise returns prompt for manual compression
memory_primerOne-call context primer: top memories + categories + session file changes. Auto-injected at session start
memory_merge_sessionsMerge observations across parallel sessions for a file. Deduplicates and optionally auto-promotes to memory
memory_export_gistExport memory entries to a GitHub Gist (public or private). Uses GITHUB_TOKEN or gh CLI
memory_import_gistImport entries from a GitHub Gist. Merges with existing entries (union of tags, max confidence)
memory_secretEncrypted secrets vault (secrets.toon, AES-256-GCM): store/get/list/forget. Keeps data.toon readable while sensitive values stay encrypted at rest. Requires TOO
memory_export_globalWrite current project memory to the global file (~/.toon-memory/memory/global.toon). One-shot share of cross-project conventions
memory_import_globalMerge cross-project conventions from the global file into this project (one-shot, deterministic, offline). merge: false replaces instead
memory_graph_pathBFS shortest path between two entries in the knowledge graph. Shows how concepts are connected
context_briefOne-call context briefing: memory + sessions + health in compact markdown. Use instead of 5-6 separate memory_ calls. Zero LLM, pure deterministic aggregation
context_generateFull project briefing: combines project structure, git state, memory entries, and active sessions in one call. Replaces 5-6 manual tool calls
context_diffIncremental briefing: git commits + modified files + new/updated memory + active sessions since last session
context_focusHyper-focused briefing: only relevant memory + related source files + callers + test files for a query
context_healthMemory health audit: orphan links, duplicates, broken file refs, expired TTL, stale sessions, score 0–100
context_exportExport memory as markdown: injectable context for system prompts (full or compact)
memory_pinPin an entry with priority 1-5: pinned entries always appear first in recall results sorted by priority, even without a keyword match
memory_unpinUnpin an entry: remove the priority flag
memory_searchUnified search with filters: same as memory_recall plus category, tags, from_date, to_date filters. Tag filter uses AND logic — all specified tags must match. b
memory_tagBatch tag operations: add, remove, or set tags on one or more entries by key or id
PromptDescription
summarize_project_contextAnalyze current TOON memory and generate a compact project summary. Optional intent parameter to focus on a specific area
FactorWeight
Tags0.3 max
Links0.2 max
Recency0.1 max
Specificity0.1 max
Origin+0.1/−0.05
SourceConfidence
Inferred0.65–0.75
Uncertain0.50

How to install the Toon Memory MCP Server

{
  "mcpServers": {
    "toon-memory": {
      "command": "npx",
      "args": [
        "-y",
        "toon-memory",
        "mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Toon Memory to memory remember.”
  • “Use Toon Memory to memory recall.”
  • “Use Toon Memory to memory smart recall.”

Frequently asked questions

Offline persistent memory for AI coding agents — 37 tools, 80% fewer calls, no LLM Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.