ClawMem
UnclaimedOn-device memory layer for AI agents. Claude Code, OpenClaw and Hermes. Hooks + MCP server + hybrid RAG search.
Set up this server
01 / Choose your client
02 / Before you connect
Authentication is not specified. Check the project instructions before connecting.
Project instructions03 / Add the configuration
claude mcp add --transport stdio 'clawmem' -- 'npx' '-y' 'clawmem'04 / Check it in your client
Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.
More in Databases
Browse the full directoryUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverSecurity profile
Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works
32 of 32 tools
Documented tools (32)
From project documentation. A server handshake does not verify each tool’s description or behavior.
beads_sync
Sync Beads issues from Dolt backend (bd CLI) into memory: syncs the full backlog (no 50-issue cap), creates docs, bridges all dep types to memoryrelations, surfaces bd ≥1.1.0 claim leases, runs A-MEM enrichment
build_graphs
Build temporal and/or semantic graphs from document corpus
diary_read
Read recent diary entries. Filter by agent name.
diary_write
Write a diary entry. Use for recording important events, decisions, or observations in environments without hook support. Stored as searchable memories.
find_causal_links
Trace decision chains: "what led to X", "how we got from A to B". Follow up intentsearch with this tool on a top result to walk the full causal chain. Traverses causes / causedby / both up to N hops with depth-annotated reasoning.
find_similar
USE THIS for "what else relates to X", "show me similar docs". Finds k-NN vector neighbors — discovers connections beyond keyword overlap that search/query cannot find.
get
Retrieve single document by path or docid
index_stats
Detailed stats: types, staleness, access counts, sessions
intent_search
USE THIS for "why did we decide X", "what caused Y", "who worked on Z". Classifies intent (WHY/WHEN/ENTITY/WHAT), traverses causal + semantic graph edges. Returns decision chains that query() cannot find.
kg_query
Query the SPO knowledge graph: "what does X relate to?", "what was true about X when?". Returns temporal entity-relationship triples with validity windows. Accepts entity name (resolved via searchEntities) or canonical ID in vault:type:slug form. Triples are populated by the decision-extractor hook
lifecycle_restore
Restore documents that were auto-archived by lifecycle policies. Filter by query, collection, or restore all
lifecycle_status
Document lifecycle statistics: active, archived, forgotten, pinned, snoozed counts and policy summary
lifecycle_sweep
Run lifecycle policies: archive stale docs past retention threshold. Archives only — never deletes. Defaults to dryrun (preview only)
list_vaults
Show configured vault names and paths. Empty in single-vault mode.
memory_evolution_status
Show how a document's A-MEM metadata evolved over time
memory_forget
Search → deactivate closest match (with audit trail). Weak matches return a disambiguation list instead of acting (v0.23.0)
memory_pin
Pin a memory: lifecycle retention + priority among relevance-equivalent results (+0.3 composite boost on hook/query surfaces; exact-tie precedence on the raw routes — vector + search non-recency). USE PROACTIVELY when: user states a persistent constraint, makes an architecture decision, or corrects
memory_rank
Ranking diagnostic (v0.36.0): real-pipeline composite breakdown per result — weights, recency, confidence blend, quality/length/frequency/canonical multipliers, signed pinΔ, co-activation — plus raw-vs-composite rank shifts; demoted raw winners stay visible. FTS-only candidates; read-only.
memory_retrieve
Preferred entry point. Auto-classifies query and routes to optimal backend (query, intentsearch, sessionlog, findsimilar, or queryplan). Use instead of manually choosing a search tool.
memory_snooze
Temporarily hide a memory from context surfacing until a date. USE PROACTIVELY when <vault-context> repeatedly surfaces irrelevant content — snooze for 30 days instead of ignoring it.
memory_stats
Lifecycle + ranking-metadata aggregates per collection (v0.36.0): origin×active cross-tabs, pinned, accrual, deactivation reasons, and access/confidence/quality/effective-age distributions (mean/median/min/max over active rows). Deeper than indexstats; includes system collections.
multi_get
Retrieve multiple docs by glob or comma-separated list
profile
Current static + dynamic user profile
query
Full hybrid pipeline (BM25 + vector + rerank) — general-purpose when query type is unclear. WRONG for "why" questions (use intentsearch) or cross-session queries (use sessionlog). Prefer memoryretrieve for auto-routing. Intent hint, strong-signal bypass, chunk dedup, candidateLimit, MMR diversity, c
query_plan
USE THIS for complex multi-topic queries ("tell me about X and also Y", "compare A with B"). Decomposes into parallel typed clauses (bm25/vector/graph), executes each, merges via RRF. query() searches as one blob — this tool splits topics and routes each optimally.
reindex
Trigger vault re-scan
search
BM25 keyword search — for exact terms, config names, error codes, filenames. v0.24.0: non-recency queries rank by the RAW BM25 transform (scoreBasis: "fts-bm25"; judged keyword eval MRR 0.848 vs composite 0.415; metadata breaks exact ties only; minScore filters raw, no default); recency-intent queri
session_log
USE THIS for "last time", "yesterday", "what happened", "what did we do". Returns session history with handoffs and file changes. DO NOT use query() for cross-session questions — this tool has session-specific data that search cannot find.
status
Index health with content type distribution
timeline
Show the temporal neighborhood around a document — what was created/modified before and after it. Progressive disclosure: search → timeline (context) → get (full content). Supports same-collection scoping and session correlation.
vault_sync
Index markdown from a directory into a named vault. Restricted-path validation rejects sensitive directories.
vsearch
Vector semantic search — for conceptual/fuzzy matching when exact keywords are unknown. v0.22.0: non-recency queries rank by RAW cosine (scoreBasis: "vector-cosine"; metadata breaks exact ties only; minScore filters raw with no default); recency-intent queries keep composite. Collection filter suppo
Tool change history
FAQ
Questions about ClawMem MCP Server
- How do I connect ClawMem MCP Server to Claude?
- Run `claude mcp add clawmem -- npx -y clawmem` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
- Is ClawMem MCP Server free?
- The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
- What can ClawMem MCP Server do?
- ClawMem MCP Server documents 32 tools to the agent, including beads_sync, build_graphs, diary_read. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.