// MCP TOOL REFERENCE

CLAWMEM TOOLS

30 tools from the ClawMem MCP Server, categorised by risk level.

// ALL 30 CLAWMEM TOOLS

READ 21 tools

Read beads_sync Sync Beads issues from Dolt backend (bd CLI) into ClawMem search index. Queries live Dolt database — no sta... Read diary_read Read recent diary entries. Use to review past observations and events recorded by the agent. Read find_causal_links USE THIS to trace decision chains: Read find_similar USE THIS for Read get Retrieve document by file path or docid. Read index_stats Detailed index statistics with content type distribution, staleness info, and memory health. Read intent_search USE THIS for Read kg_query Query the knowledge graph for an entity Read lifecycle_status Show document lifecycle statistics: active, archived, forgotten, pinned, snoozed counts and policy summary. Read list_vaults Show all configured vault names and their SQLite paths. Returns empty if running in single-vault mode (defa... Read memory_evolution_status Get the evolution timeline for a memory document, showing how its keywords and context have changed over ti... Read memory_retrieve Unified memory retrieval — classifies your query and routes to the optimal search backend automatically. Us... Read multi_get Retrieve multiple documents by glob pattern or comma-separated list. Read profile Get the current user profile (static facts + dynamic context). Rebuild if stale. Read query Full hybrid search (BM25 + vector + rerank). General-purpose — use when query type is unclear. WRONG: query( Read query_plan USE THIS for complex multi-topic queries ( Read search Keyword (BM25) search for exact term lookup. Use for config names, error codes, specific filenames. DO NOT ... Read session_log USE THIS when user references prior sessions: Read status Show ClawMem index status with content type distribution. Read timeline Show the temporal neighborhood around a document — what was created/modified before and after it. Token-eff... Read vsearch Vector similarity search for conceptual/fuzzy matching. Use when exact keywords are unknown. DO NOT use for...

WRITE 5 tools

Write memory_snooze Temporarily hide a memory from context surfacing. USE PROACTIVELY when vault-context repeatedly surfaces ir... Write vault_sync Index markdown documents from a directory into a named vault. Use to populate a vault with content from a s... Write diary_write Write to the agent Write lifecycle_restore Restore documents that were auto-archived by lifecycle policies. Does NOT restore manually forgotten docume... Write memory_pin Pin a memory for permanent prioritization (+0.3 boost). USE PROACTIVELY when: user states a persistent cons...

DESTRUCTIVE 2 tools

Destructive lifecycle_sweep Run lifecycle policies: archive stale docs, optionally purge old archives. Defaults to dry_run (preview only). Destructive memory_forget Remove a memory by searching for the closest match and deactivating it.

EXECUTE 2 tools

Execute build_graphs Build temporal and semantic graphs for MAGMA multi-graph memory. Run after indexing documents. Execute reindex Trigger a re-scan of all collections. Detects new, changed, and deleted documents.

// FAQ

How many tools does the ClawMem MCP server have? +

The ClawMem MCP server exposes 30 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on ClawMem tools? +

Route the ClawMem server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do ClawMem tools fall into? +

ClawMem tools are categorised as Read (21), Write (5), Destructive (2), Execute (2). Each category has a recommended default policy.

Enforce policy on every ClawMem tool call.

Deterministic rules across all 30 ClawMem tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

GOVERN CLAWMEM →

Free to start. No card required.

42,500+ MCP servers and 110,000+ tools scanned and risk-classified.