Th Memory MCP

Status: v2.3.0 - a temporal, conflict-aware, hybrid-retrieval memory engine. 16 MCP tools, 25 passing test suites. Non-destructive schema migration from v1 (all v1 data preserved). New in v2.2: lifecycle states, temporal validity, conflict/dedup resolution with USER/SESSION/PROJECT/GLOBAL scope, hybrid FTS+vector retrieval (RRF), memory graph, get_context assembly, periodic consolidation, and link_memory /…

People who work with developer tools, local first and memory and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-14 · ★ 3 · #68 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Th Memory MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add worakorn-prince-th-memory-mcp -- npx -y th-memory-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "worakorn-prince-th-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "th-memory-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-26 - young repo, little track record yet

license MIT - declared in the repository

npm package th-memory-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.worakorn-prince is GitHub-verified and matches the repo owner

03 · What Th Memory MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search preferences + lessons (FTS5) + recent matching interactions. Use before starting a new task, search past user prompts by keyword (200-char snippets per row), delete one memory row (preference/lesson/interaction) by id (+type prevents cross-table id clash), and list recent raw interactions (filter by kind) - feedstock for Smart Distill.

Capability map

Tools grouped from the project's README - what Th Memory MCP lets an agent do.

read & search

4 tools - e.g. user profile overview: profile sections + top preferences + 5 most recent lessons; search past user prompts by keyword (200-char snippets per row); list recent raw interactions (filter by kind)…

get_profile · search_history · get_recent_interactions · get_context

Remember

1 tool - e.g. upsert preference (category+key) - re-saving the same key increases confidence by 0.1 (cap 1.0)

remember

Recall

1 tool - e.g. search preferences + lessons (FTS5) + recent matching interactions. Use before starting a new task

recall

Save

1 tool - e.g. record a lesson learned from a correction (situation / mistake / correction)

save_lesson

Forget

1 tool - e.g. delete one memory row (preference/lesson/interaction) by id (+type prevents cross-table id clash)

forget

Memory

1 tool - e.g. memory statistics: counts by kind, DB size, oldest/newest interaction, profile sections

memory_stats

Export

1 tool - e.g. export memory to JSON under data/exports/ only (filename auto-sanitized)

export_memory

Consolidate

1 tool - e.g. cluster similar memories via embedding similarity; optionally create derived/consolidated memories linked via derived_from

consolidate

Latest releases

v2.3.0 · 2026-09-15

What's new in v2.3.0 (v2.2.9..v2.3.0, 2 commits): · New th-memory CLI (dist/cli.js): remember/recall/stats/forget commands; PUBLISH bin docs updated. · Highlight underline: new src/lib/highlight.ts (underline) +…

v2.2.9 · 2026-09-13

v2.2.9 - Export hardening + test/viewer sync. Feat: export covers entities/users/relations, forget deletes associated links, fail-closed migration with shared ISO helper. Fix: eliminate FTS N+1, include smoke in test…

v2.2.8 · 2026-09-01

v2.2.8 - Critical scope fix + rescale. Fix: scope contamination 0.75->0 (critical GLOBAL leak) via temporal suite, conflict false 0->1 via reset, graph hop1 0.52->1.0 via includeGraph. Chore: rescale profiles…

04 · Who maintains Th Memory MCP

th-memory-mcp is maintained by worakorn-prince. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

repository: github.com/worakorn-prince/th-memory-mcp
category: memory - ranked #68 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-15)
registry: io.github.worakorn-prince/th-memory-mcp (active, first published 2026-08-28 · 2 versions)
packages: npm:th-memory-mcp

06 · Th Memory MCP FAQ

Is Th Memory MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-14 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Th Memory MCP do?

How do I install Th Memory MCP?

Run `npx -y th-memory-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Th Memory MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Th Memory MCP

Alternatives to Th Memory MCP

Maintained memory servers if Th Memory MCP isn't the fit.

Pairs well with

Servers that cover what Th Memory MCP doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Lean Memory · Longhand · Agent Memory · fojin - Buddhist Canon Tools · Agent Memory Os

More TypeScript MCP servers · Chestnyi Znak MCP Server · Max Messenger · Ozon Seller MCP Server · Woocommerce MCP · Wraps · see all