bumblebiber avatar

hmem — Humanlike Memory for AI Agents

bumblebiber/hmem

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 tools

Public 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_DIR

Directory where .hmem SQLite databases are stored. Defaults to ~/.hmem/

Readme

hmem — Humanlike Memory for AI Agents

mcpindex

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 now hmem again — pure memory framework, nothing else. The its-over-9k name 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


View the full README on GitHub

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

Related Databases MCP servers

View all
1sgx-labs avatarSAME - Stateless Agent Memory Enginesgx-labs/statelessagentPersistent memory for AI coding agents. Local-first SQLite + vector search. 17 MCP tools.19stars
2sebbsssss avatarCludesebbsssss/cludePortable agent memory anchored on Solana. Local SQLite + vector recall, open export.15stars
3meloncafe avatarChromaDB Remote MCP Servermeloncafe/chromadb-remote-mcpRemote ChromaDB vector database MCP server with streamable HTTP transport12stars
4alyiox avatarMicrosoft SQL Serveralyiox/mcp-mssqlMCP server for SQL Server metadata, parameterized queries, plan analysis, and writes opt-in.9stars
5neverinfamous avatardb-mcp (SQLite MCP Server)neverinfamous/db-mcpSQLite MCP server with OAuth 2.1, HTTP/SSE, 122 tools, and smart tool filtering0stars
6invarcore avatarKnowledge Fabricinvarcore/knowledge-fabricMulti-tenant hybrid RAG & evidence verification MCP server enforcing PostgreSQL RLS.8stars