
hmem — Humanlike Memory for AI Agents
Adds a 5-level hierarchical memory store to Claude that persists across sessions and syncs across devices. You get 13 MCP tools for reading, writing, and searching a SQLite-backed knowledge tree where Level 1 loads one-line summaries (~5k tokens for 300+ entries) and deeper levels drill down on demand. Built for project-based AI work: automatic session capture, Haiku background checkpoints that extract decisions and write handoff notes, and a load_project() call that briefs the agent in ~3000 tokens on stack, bugs, roadmap, and where you left off yesterday. Ships with 21 versioned skills that define agent behavior patterns and a TypeScript SDK if you want to embed the store directly into your own tooling.
- GitHub stars
- 20
- tools
- 23
- transport
- STDIO
- env var
- 1
- last updated
- Feb 24, 2026
Tools
23 toolsPublic tool metadata for what this MCP can expose to an agent.
read_memory5-level lazy read — by ID, prefix, search, time, or tag
5-level lazy read — by ID, prefix, search, time, or tag
No parameter schema in public metadata yet.
write_memoryCreate new entries with title, body, tags, links
Create new entries with title, body, tags, links
No parameter schema in public metadata yet.
append_memoryAdd child nodes to existing entries
Add child nodes to existing entries
No parameter schema in public metadata yet.
update_memoryPatch fields: title, body, tags, irrelevant, links
Patch fields: title, body, tags, irrelevant, links
No parameter schema in public metadata yet.
search_memoryFTS5 full-text search with sub-node attribution
FTS5 full-text search with sub-node attribution
No parameter schema in public metadata yet.
find_relatedFind contextually related entries by tag overlap
Find contextually related entries by tag overlap
No parameter schema in public metadata yet.
load_projectActivate a project + get full briefing + recent sessions
Activate a project + get full briefing + recent sessions
No parameter schema in public metadata yet.
read_projectRead project without activating (comparison/reference)
Read project without activating (comparison/reference)
No parameter schema in public metadata yet.
create_projectScaffold a new project entry with standard schema
Scaffold a new project entry with standard schema
No parameter schema in public metadata yet.
list_projectsList all projects with status summary
List all projects with status summary
No parameter schema in public metadata yet.
flush_contextPersist current session context to long-term memory
Persist current session context to long-term memory
No parameter schema in public metadata yet.
move_nodesMove a subtree under a different parent (also in curate server)
Move a subtree under a different parent (also in curate server)
No parameter schema in public metadata yet.
set_active_deviceRegister and switch between devices
Register and switch between devices
No parameter schema in public metadata yet.
memory_statsPer-prefix counts, total tokens, favorites, hashtags, stale-list
Per-prefix counts, total tokens, favorites, hashtags, stale-list
No parameter schema in public metadata yet.
memory_healthFind broken links, orphan tags, empty entries, dangling chains
Find broken links, orphan tags, empty entries, dangling chains
No parameter schema in public metadata yet.
export_memoryExport the full .hmem to a portable JSON snapshot
Export the full .hmem to a portable JSON snapshot
No parameter schema in public metadata yet.
import_memoryImport a JSON snapshot back into a .hmem (destructive)
Import a JSON snapshot back into a .hmem (destructive)
No parameter schema in public metadata yet.
update_manyBulk-patch a set of entries (irrelevant, tags, body, etc.)
Bulk-patch a set of entries (irrelevant, tags, body, etc.)
No parameter schema in public metadata yet.
tag_bulkAdd/remove a tag across many entries
Add/remove a tag across many entries
No parameter schema in public metadata yet.
tag_renameRename a tag globally across all entries
Rename a tag globally across all entries
No parameter schema in public metadata yet.
move_memoryMove an entire entry to a new ID slot
Move an entire entry to a new ID slot
No parameter schema in public metadata yet.
rename_idRename an entry's ID; rewrites all inbound links
Rename an entry's ID; rewrites all inbound links
No parameter schema in public metadata yet.
reset_memory_cacheInvalidate the in-memory L1 cache (after raw SQL writes)
Invalidate the in-memory L1 cache (after raw SQL writes)
No parameter schema in public metadata yet.
Sponsors
Configuration
HMEM_STORAGE_DIRDirectory where .hmem SQLite databases are stored. Defaults to ~/.hmem/
Readme
hmem — Humanlike Memory for AI Agents
Your AI forgets everything between sessions. hmem fixes that.
One load_project() call. ~3000 tokens. Your agent knows everything important about a project — every past mistake, every decision, every open task — across sessions, devices, and AI providers. No setup per conversation. No "let me re-read the codebase." It just remembers.
AI agent? Skip this file. Read AGENT_SETUP.md — written for you, not for humans.
Naming note (v8.0): This package was briefly published as
its-over-9k(1.x). It is nowhmemagain — pure memory framework, nothing else. Theits-over-9kname lives on as a separate project: the o9k token-efficiency meta-framework, which combines skills/plugins like this one. Related: TIM — hmem's next-generation successor (hypergraph memory, CRDT sync).
What This Is
Details
- Repository
- github.com/bumblebiber/hmem
- Website
- github.com/Bumblebiber/hmem#readme
- Categories
- Databases, AI & LLM Tools
- Package
hmem-mcp- Transport
- STDIO
- Registry
- MCP registry, active