Total Agent Memory MCP Server

total-agent-memory (TAM) is an open-source memory server for AI coding agents. Coding agents start every session without memory of earlier ones, so decisions, fixes and project conventions have to be explained again. TAM stores decisions, solutions, facts, errors and session summaries on your machine and returns them through the Model Context Protocol (MCP), so any MCP client can use it without code changes.

People who work with ai memory, claude code mcp and codex cli and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-30 · ★ 72 · #27 OF 321 MAINTAINED MEMORY · VERIFIED 2026-09-30

MIT · Python servers · how we verify → /methodology

01 · Install Total Agent Memory

before you install - you'll need

Set TAM_MEMORY_DIR, FASTEMBED_CACHE_PATH before connecting.

Claude Code

claude mcp add vbcherepanov-total-agent-memory -- uvx total-agent-memory

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "vbcherepanov-total-agent-memory": {
      "command": "uvx",
      "args": [
        "total-agent-memory"
      ]
    }
  }
}

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

license MIT - declared in the repository

pypi package total-agent-memory - check the name against the project README before installing (PyPI has no namespace ownership)

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

03 · What Total Agent Memory can do

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

Latest releases

v14.7.0 · 2026-09-30

Whole records fill the context budget, and TAM on the AMA-Bench board. · Recall · memory_recall(mode="context", fill_budget=true) searches up to 100 hits deep and keeps whole records, in rank order, until…

v14.6.0 · 2026-09-28

A company memory server you can run, and a stricter personal install. · Company server · tam setup asks "Just me" or "Company server". A new team server shows a one-time setup code and runs a web wizard at /dashboard/.…

v14.5.1 · 2026-09-24

Recall no longer ranks a record above its own later update. The cross-encoder that 14.5.0 turned on is trained on web search and knows the real-world value, so it lifted "The company that produced Windows Vista is…

04 · Who maintains Total Agent Memory

Total Agent Memory is maintained by vbcherepanov. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/vbcherepanov/total-agent-memory
website: https://totalmemory.dev/
category: memory - ranked #27 of 321 actively-maintained memory servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-30)
registry: io.github.vbcherepanov/total-agent-memory (active, first published 2026-09-07 · 11 versions)
packages: pypi:total-agent-memory

06 · Total Agent Memory FAQ

What is Total Agent Memory?

Is Total Agent Memory still maintained?

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

How do I install Total Agent Memory?

Run `uvx total-agent-memory`. The README documents 2 environment variables (TAM_MEMORY_DIR, FASTEMBED_CACHE_PATH) to set first. Set TAM_MEMORY_DIR, FASTEMBED_CACHE_PATH before connecting. You can also paste the ready-made client config above.

Does Total Agent Memory run locally?

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

07 · Alternatives to Total Agent Memory

Alternatives to Total Agent Memory

Maintained memory servers if Total Agent Memory isn't the fit.

Pairs well with

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

More memory MCP servers · Memento · Veracium · Auto Mem · Peon Mem · Wander Agent

More Python MCP servers · Agent Services · Financekit MCP · Siteaudit MCP · Coalent · PDF Card MCP · see all