Th-memory-mcp Server

No external services, accounts, or API keys are required — everything lives in a single local SQLite file.

Local serverstdioMIT

What is the Th-memory-mcp Server?

Th-memory-mcp source profile. From the maintainer documentation: “No external services, accounts, or API keys are required — everything lives in a single local SQLite file.”

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
rememberupsert preference (category+key) — re-saving the same key increases confidence by 0.1 (cap 1.0)
recallsearch preferences + lessons (FTS5) + recent matching interactions. Use before starting a new task
get_profileuser profile overview: profile sections + top preferences + 5 most recent lessons
save_lessonrecord a lesson learned from a correction (situation / mistake / correction)
search_historysearch past user prompts by keyword (200-char snippets per row)
forgetdelete one memory row (preference/lesson/interaction) by id (+type prevents cross-table id clash)
memory_statsmemory statistics: counts by kind, DB size, oldest/newest interaction, profile sections
get_recent_interactionslist recent raw interactions (filter by kind) — feedstock for Smart Distill
export_memoryexport memory to JSON under data/exports/ only (filename auto-sanitized)
get_contextassemble relevant memories for the current task via hybrid retrieval (+ optional graph expansion) with token budgeting
consolidatecluster similar memories via embedding similarity; optionally create derived/consolidated memories linked via derived_from
link_memorycreate a typed relationship between two memories in the graph (supports/contradicts/supersedes/derived_from/related_to/caused_by/depends_on)
merge_memorymerge a duplicate/near-duplicate into a canonical memory (source becomes superseded, provenance in metadata.merged_from)
update_memoryupdate mutable fields in place, or create a superseding memory when content changes (set supersede=false to edit in place)
import_memoryimport memories from JSON (validates type, dedupes against existing, never overwrites blindly); dry-run by default, apply=true to insert
extract_memoriesscan recent captured interactions for memory-intent phrases and propose memory candidates (deterministic, no LLM); dry-run by default, apply=true to create…