io.github.davidmosiah/delx-memory
Local-first persistent memory MCP: shared SQLite key/value store, searchable, TTL-aware, secret-safe
Versions
0.2.0latestTools 15
memory_agent_manifest Machine-readable install and operating instructions for AI agents. Call first when onboarding. Supports privacy_mode documentation for read tools.
memory_connection_status Local SQLite path readiness and size without reading entry values. Safe first call every session.
memory_data_inventory Static inventory of memory domains, privacy modes and recommended first calls. No live value reads.
memory_capabilities Self-description of this MCP including privacy modes and mutation gating.
memory_get Exact key lookup. Returns the stored value plus timestamps, ttl, tags, metadata. Returns null if missing or expired. Optional privacy_mode=summary omits full values.
memory_list List keys with optional prefix, tag, or since (updated_at) filter. Returns keys + timestamps + tags only — call memory_get for values. Scoped by DELX_MEMORY_NAMESPACE when set.
memory_search Full-text search across keys, values AND tags. Uses an FTS5 index with bm25 relevance ranking (key-weighted), word-stemming, diacritic folding and prefix matching — so multi-word, partial and accent-insensitive queries all hit, ranked by relevance. Falls back to a LIKE substring scan if the SQLite build lacks FTS5. Returns top N matches with a snippet. Case-insensitive. privacy_mode=summary omits snippets.
memory_stats High-level stats about the local memory store. Safe to call first on every session to gauge whether the store is empty, small, or large.
memory_set Create or update a key in memory. Rejects credential-shaped keys or values. Requires explicit_user_intent: true. Returns whether the row was created or updated.
memory_forget Delete a single key from memory. Idempotent: returns existed=false if the key was not present. Requires explicit_user_intent: true.
memory_forget_by_tag Delete every entry carrying the given tag. Returns deleted_count. Requires explicit_user_intent: true.
memory_export Dump the memory store as JSON, JSONL, or Markdown. Optional since/until window on updated_at. Use for backup/inspection. Requires explicit_user_intent: true.
memory_get_many Batch exact-key lookup (max 50). Missing keys omitted. Respects DELX_MEMORY_NAMESPACE.
memory_set_batch Upsert up to 50 entries in one SQLite transaction. One explicit_user_intent covers the batch. Rejects secret-shaped keys/values. Namespace-aware.
memory_handoff Returns store stats + the most recently updated keys (optional values). Designed for session start: one call instead of stats+list+get fan-out. Namespace-aware.
Permissions 3
network medium shell high env_vars low