ClawMem MCP Server

Integrates via Claude Code hooks, an MCP server (works with any MCP-compatible client), a native OpenClaw plugin, or a Hermes Agent MemoryProvider plugin. All paths write to the same local SQLite…

Local serverstdioMIT

What is the ClawMem MCP Server?

ClawMem is an MCP project maintained in the yoloshii/clawmem repository. The maintainer describes its purpose as “Integrates via Claude Code hooks, an MCP server (works with any MCP-compatible client), a native OpenClaw plugin, or a Hermes Agent MemoryProvider plugin. All paths…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /absolute/path/to/clawmem/bin/clawmem. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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_retrievePreferred entry point. Auto-classifies query and routes to optimal backend (query, intent_search, session_log, find_similar, or query_plan). Use instead of…
searchBM25 keyword search — for exact terms, config names, error codes, filenames. v0.24.0: non-recency queries rank by the RAW BM25 transform (scoreBasis…
vsearchVector semantic search — for conceptual/fuzzy matching when exact keywords are unknown. v0.22.0: non-recency queries rank by RAW cosine (scoreBasis…
queryFull hybrid pipeline (BM25 + vector + rerank) — general-purpose when query type is unclear. WRONG for "why" questions (use intent_search) or cross-session…
getRetrieve single document by path or docid
multi_getRetrieve multiple docs by glob or comma-separated list
find_similarUSE THIS for "what else relates to X", "show me similar docs". Finds k-NN vector neighbors — discovers connections beyond keyword overlap that search/query…
intent_searchUSE 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.…
query_planUSE 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)…
build_graphsBuild temporal and/or semantic graphs from document corpus
find_causal_linksTrace decision chains: "what led to X", "how we got from A to B". Follow up intent_search with this tool on a top result to walk the full causal chain.…
kg_queryQuery the SPO knowledge graph: "what does X relate to?", "what was true about X when?". Returns temporal entity-relationship triples with validity windows.…
memory_evolution_statusShow how a document's A-MEM metadata evolved over time
timelineShow the temporal neighborhood around a document — what was created/modified before and after it. Progressive disclosure: search → timeline (context) → get…
beads_syncSync Beads issues from Dolt backend (bd CLI) into memory: syncs the full backlog (no 50-issue cap), creates docs, bridges all dep types to memory_relations…
list_vaultsShow configured vault names and paths. Empty in single-vault mode.
vault_syncIndex markdown from a directory into a named vault. Restricted-path validation rejects sensitive directories.
diary_writeWrite a diary entry. Use for recording important events, decisions, or observations in environments without hook support. Stored as searchable memories.
diary_readRead recent diary entries. Filter by agent name.
memory_forgetSearch → deactivate closest match (with audit trail). Weak matches return a disambiguation list instead of acting (v0.23.0)
memory_pinPin a memory: lifecycle retention + priority among relevance-equivalent results (+0.3 composite boost on hook/query surfaces; exact-tie precedence on the raw…
memory_snoozeTemporarily hide a memory from context surfacing until a date. USE PROACTIVELY when repeatedly surfaces irrelevant content — snooze for 30 days instead of…
statusIndex health with content type distribution
reindexTrigger vault re-scan
index_statsDetailed stats: types, staleness, access counts, sessions
memory_statsLifecycle + ranking-metadata aggregates per collection (v0.36.0): origin×active cross-tabs, pinned, accrual, deactivation reasons, and…
memory_rankRanking diagnostic (v0.36.0): real-pipeline composite breakdown per result — weights, recency, confidence blend, quality/length/frequency/canonical…
session_logUSE THIS for "last time", "yesterday", "what happened", "what did we do". Returns session history with handoffs and file changes. DO NOT use query() for…
profileCurrent static + dynamic user profile
lifecycle_statusDocument lifecycle statistics: active, archived, forgotten, pinned, snoozed counts, the deactivation-reason breakdown, and policy summary
lifecycle_sweepRun lifecycle policies: archive stale docs past retention threshold. Archives only — never deletes. Defaults to dry_run (preview only)
lifecycle_restoreRestore documents that were auto-archived by lifecycle policies. Filter by query, collection, or restore all

How to install the ClawMem MCP Server

{
  "mcpServers": {
    "clawmem": {
      "command": "/absolute/path/to/clawmem/bin/clawmem",
      "args": [
        "mcp"
      ]
    }
  }
}

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