total-agent-memory
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
total-agent-memory
Persistent memory for Claude Code, Codex CLI, Cursor, Cline and any MCP client. Local-first. Hits #5 on LoCoMo and 96.2% R@5 on LongMemEval.
npx -y total-agent-memory connect claude-code
# → server installed in ~/.tam, IDE wired, dashboard live at
# http://127.0.0.1:37737One command bootstraps a Python virtual env in ~/.tam/, installs the
MCP server and registers two background services with your OS:
Dashboard — web UI on
http://127.0.0.1:37737(LaunchAgent on macOS, systemd-user unit on Linux, Scheduled Task on Windows). Survives reboot.Reflection — file-watch drain of the reflection queues. Fires whenever the server touches
~/.tam/.reflect-pending(debounce 10s).
Pass --no-services to skip the auto-service install.
Quick start
# Onboard (install + show next steps)
npx -y total-agent-memory
# Or explicit
npx -y total-agent-memory install
npx -y total-agent-memory connect claude-code
npx -y total-agent-memory connect cursor
npx -y total-agent-memory connect codex
npx -y total-agent-memory statusAlias: tam (same binary).
Related MCP server: apex-memory
Commands
Command | What it does |
| Create venv, install Python server, register dashboard + reflection services. Idempotent. |
| Run the MCP server (stdin/stdout). |
| Wire an IDE config. |
| Manage background services: |
| Health-check end-to-end. |
| Print install paths, DB size, service status, dashboard HTTP probe. |
| Diagnose Python/uv/git on PATH. |
| Pull the latest server version. |
| Remove |
Options
Flag | Meaning |
| Pin a specific server release. |
| Force install source. Default: PyPI with GitHub fallback. |
| Override install dir (default |
| Skip dashboard / reflection auto-install. |
| Skip prompts (needed for |
| Disable ANSI. |
| Print every shell command. |
Requirements
Node ≥ 18 (you already have it if you're reading this).
Python ≥ 3.11 on PATH. The wrapper will tell you how to install it if missing.
Optional: uv — 10× faster installs, auto-detected.
What gets installed
~/.tam/
├── .venv/ # isolated Python env
│ └── bin/total-agent-memory # MCP server entry-point
├── logs/
│ ├── dashboard.log
│ └── reflection.log
├── memory.db # SQLite — your memory lives here
└── .reflect-pending # touched on every save → triggers reflectionBackground services registered with your OS:
OS | Location |
macOS |
|
Linux |
|
Windows | Task Scheduler — |
Nothing system-wide. Uninstall with tam uninstall --yes (removes services first).
Verify
tam dashboard status
# ● dashboard running
# ◉ reflection watching
# ✓ HTTP http://127.0.0.1:37737 → 200Links
Site: https://totalmemory.dev
Server source: https://github.com/vbcherepanov/total-agent-memory
PyPI package:
total-agent-memory(legacyclaude-total-memoryis now a deprecation shim)
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to maintain persistent, cross-session memory of codebase architecture, naming conventions, and decisions through MCP tools. Eliminates repetitive project re-explanation by automatically injecting stored context into every session with local-first SQLite storage and optional team sharing capabilities.4MIT
- AlicenseNot gradedqualityDmaintenancePersistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.24 npm2MIT
- AlicenseBqualityBmaintenancePersistent, local memory for AI coding agents that learns how you work, not just what you said. Supports Claude Code, Codex CLI, Cursor, and any MCP client.7998 PyPI77MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that provides offline-first, persistent memory for AI coding assistants. It captures project decisions and conventions into a local SQLite database and syncs them to tool-specific memory files like CLAUDE.md and AGENTS.md.4 npmMIT