Toon Memory
Offline persistent memory for AI coding agents — 35 tools, 80% fewer calls, no LLM
Connector by LuiggiVal08 · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/luiggival08-toon-memory
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 16 read · 13 write · 9 delete
- Secrets
- 3 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 38
Read from the source code; the running server may list different tools.
Read 16 · Look things up without changing anything.
context_briefcontext_diffcontext_exportcontext_focuscontext_generatecontext_healthmemory_compressmemory_diffmemory_graph_pathmemory_primermemory_reflectmemory_sessions
Show 4 more tools
memory_smart_recallmemory_statsmemory_suggestmemory_visualize
Write 13 · Create, change, send or run things.
memory_backupmemory_capturedmemory_checkpointmemory_export_gistmemory_export_globalmemory_merge_sessionsmemory_pinmemory_promotememory_recallmemory_remembermemory_searchmemory_secret
Show 1 more tools
memory_summary
Delete 9 · Delete, drop, revoke or wipe things.
memory_archivememory_consolidatememory_decryptmemory_encryptmemory_forgetmemory_import_gistmemory_import_globalmemory_tagmemory_unpin
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GITHUB_TOKENTOON_MEMORY_KEYTOON_MEMORY_NO_SESSION
Other settings (environment variables or headers).
TOON_MEMORY_BRANCHTOON_MEMORY_CAPTURETOON_MEMORY_SESSION_ID
Network hosts it talks to 6
api.github.com· found in coded3js.org· found in codegist.github.com· found in codegithub.com· found in codeluiggival08.github.io· found in coderaw.githubusercontent.com· found in code
Files it touches
- Your home directory (~)
- Any path the agent passes to its tools
Tools (38)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
context_briefContext Briefingread-onlyGenerate a compact context briefing: relevant memory + active sessions + project health. Single call instead of 5-6 separate calls. Zero LLM, pure deterministic logic.
context_diffContext Diffread-onlyWhat changed since the last session: git commits + modified files + new/updated memory entries. Zero LLM.
context_exportExport Memory as Markdownread-onlyExport all memory as markdown injectable for other agents or sessions. Full (detailed) or compact format. Zero LLM.
context_focusFocus Context for Taskread-onlyHyper-focused context for a specific task: relevant entries + related files + code referencing the symbol + existing tests. Zero LLM.
context_generateGenerate Full Contextread-onlyGenerate a full system prompt: project (package.json, deps, framework) + git (branch, commits) + memory (relevant entries) + sessions. Single call to prepare the agent. Zero LLM.
context_healthMemory Health Auditread-onlyFull memory health audit: orphan links, duplicates, broken refs, expired TTL, quality, stale sessions. Includes score 0-100. Zero LLM.
memory_archiveArchive Old Entriescan change or delete dataMove old entries (>30 days) to archive.toon to keep memory clean.
memory_backupBackup MemoryCreate a timestamped backup of the memory file. Use before major operations or to preserve state.
memory_capturedList Captured ActivityShow activity log captured automatically by hooks (only if capture is enabled). Useful for promoting observations to memory with memory_remember.
memory_checkpointSession CheckpointSave or update a session checkpoint with 7-day TTL. Creates a knowledge entry snapshot of the current session state. Same session = upsert (single checkpoint per session). Auto-expires.
memory_compressCompress Memory Entriesread-onlyLLM-powered compression: select entries to compress into one concise entry. The agent (YOU) reads the entries, writes a compressed summary, then calls memory_remember to save it. Two-step dance: this tool provides context, you provide intelligence.
memory_consolidateConsolidate Memorycan change or delete dataCleanup operations, all deterministic (no LLM): identical removes duplicate entries (keeps the first), similar merges entries with >50% word overlap (keeps longer content, combines tags), low-quality removes entries below minQuality or without tags, versions marks entries describing the same subject with older versions obsolete in favor of the newest.
memory_decryptDisable Encryptioncan change or delete dataDisable encryption and decode memory.
memory_diffMemory Diffread-onlyShow what changed in memory since a date. Useful for seeing what was learned since the last session.
memory_encryptEnable Encryptioncan change or delete dataEnable AES-256-GCM encryption for memory. Requires TOON_MEMORY_KEY in environment.
Show 23 more tools
memory_export_gistExport to GitHub GistExport memory to a private GitHub Gist for cloud sync. Requires GITHUB_TOKEN env var. Zero deps — uses Node's built-in fetch().
memory_export_globalExport to Global MemoryWrite the current project memory to the global memory file (~/.toon-memory/memory/global.toon, or TOON_MEMORY_GLOBAL_FILE). One-shot: the global file is a plain TOON document you curate and import into other projects with memory_import_global.
memory_forgetForget from Memorycan change or delete dataLifecycle operations for a memory entry: soft (default) marks it obsolete and hides it from recalls, hard permanently removes it, restore brings it back to active, supersede retires it with a typed superseded_by edge to a newer entry.
memory_graph_pathFind Graph Pathread-onlyFind the shortest path between two memory entries in the knowledge graph. Shows how two concepts are connected through related entries.
memory_import_gistImport from GitHub Gistcan change or delete dataImport memory from a GitHub Gist. Merges entries (keeps newer dates, combines tags). Requires GITHUB_TOKEN env var.
memory_import_globalImport Global Memorycan change or delete dataMerge cross-project conventions from the global memory file (~/.toon-memory/memory/global.toon, or TOON_MEMORY_GLOBAL_FILE) into this project. One-shot merge by key: keeps newer dates, unions tags/links, preserves all fields. Deterministic and offline.
memory_merge_sessionsMerge Session ObservationsMerge observations from multiple sessions/branches into a consolidated view. Deduplicates and suggests entries to promote to memory. Inspired by Hindsight's multi-agent session merging.
memory_pinPin EntryPin a memory entry with priority level (1-5). Higher priority entries appear first in recalls. Default: 1. Useful for critical decisions, project rules, or frequently-needed context.
memory_primerSystem Primerread-onlyGenerate a compact system primer: always-current knowledge map for auto-injection into agent context. Excludes private entries, shows top memories by importance, categories, and patterns. Use at session start or when context feels stale.
memory_promotePromote ObservationsHeuristic auto-promote from the capture log (no LLM). Each observation gets a deterministic confidence score; high-confidence ones promote as active entries, low-confidence (≤ minConfidence) become reviewable drafts. Opt-in: run with dryRun: true first.
memory_recallSearch MemorySearch the project's persistent memory. Returns relevant entries. Use BEFORE reading files. Pattern: recall → context_diff for recent changes → capture to save observations.
memory_reflectReflect on Memoryread-onlyDeterministic memory audit (no LLM): tag co-occurrence themes, hub/orphan entries, near-duplicates, contradiction candidates, stale entries, and superseded-but-active entries. Signals what to link, merge, or retire.
memory_rememberSave to MemorySave a fact to the project's persistent memory (decisions, patterns, bugs, knowledge). Persists between sessions. Tags: 'private' excludes from context injection; 'superseded' marks as obsolete.
memory_searchUnified SearchSearch memory with combined filters: text query, category, tags, and date range. Returns ranked results.
memory_secretEncrypted Secrets VaultStore/retrieve secrets in the encrypted sidecar vault (secrets.toon, AES-256-GCM). Keeps data.toon readable and open while sensitive values stay encrypted at rest. Requires TOON_MEMORY_KEY. 'store' encrypts, 'get' decrypts, 'list' shows metadata only (no values), 'forget' removes.
memory_sessionsActive Sessions & Conflictsread-onlyShow active agent sessions in this project (git branch, files touched, last-seen) and detect soft conflicts (files touched by 2+ sessions). Use at startup to avoid overwriting other parallel sessions' work.
memory_smart_recallSmart Recall (Unified)read-onlyUnified retrieval: combines BM25 + graph + decay + quality in a single call. Use at the START of each task to get all relevant memory context. Then use context_diff for recent changes, context_focus for deep dives.
memory_statsMemory Statsread-onlyShow project memory statistics.
memory_suggestSuggest Related Memoriesread-onlySuggest memory entries related to a given context. Useful for gathering context before a task.
memory_summaryFile SummarySave or retrieve a summary of a large file to save tokens.
memory_tagBatch Tag OperationsBatch add, remove, or set tags on one or more memory entries by key or id.
memory_unpinUnpin EntryRemove the pin from a memory entry so it returns to normal ranking.
memory_visualizeOpen Memory Graph Viewerread-onlyOpen the interactive memory graph viewer (force-directed graph, stats, timeline, detail panel). Renders inline in MCP Apps-compatible hosts.
Signals
- Stars
- 12
- Forks
- 0
- Open issues
- 0
- Last commit
- Aug 5, 2026 (2 months ago)
- Last release
- Aug 5, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.LuiggiVal08/toon-memory- Version
- 4.3.5
- Auth
- API key
- Packages
- npm toon-memory
- License
- MIT
- Repository
- github.com/LuiggiVal08/toon-memory
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Toon Memory MCP server. Agent Mart. https://agentmart.dev/connectors/luiggival08-toon-memory (last updated 2026-10-24)