agent-memory
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agent-memorysearch my memory for notes about the payment integration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agent-memory
Local markdown memory for coding agents — any provider, any tool.
Without a shared layout, each vendor owns a graveyard — session archives that never become durable identity unless you re-teach every new agent. See abi/WHY.md for the full rationale (vs RAG, vs vaults, vs vendor memory). Reference-implementation roadmap: ROADMAP.md.
Your memory lives in folders you own: ~/.agents/memory (identity + project map) and <repo>/.agents/memory (per-project work). Your Agent — or any host that reads markdown and optional MCP — uses the same layout.
Markdown is the source of truth. The Python MCP in this repo is the reference implementation, not a proprietary backend.
ABI (stable contract)
Shipped under abi/ — versioned, documented, implementation-agnostic:
Doc | What |
Overview + conformance | |
Why this exists (vs RAG, vaults, vendor graves) | |
Reference-implementation roadmap (not ABI) | |
Folder taxonomy | |
Where facts go | |
Tool contract | |
AGENTS / CLAUDE binding | |
Windows, symlinks, per-machine paths | |
Sync, injection, scan.json, | |
Catalog / extract / distill pipeline |
Install copies abi/LAYOUT.md → ~/.agents/memory/LAYOUT.md. Injection and CLI flags: abi/INSTALL.md. Machine-readable: python -m agent_memory --help-json.
Related MCP server: mcp-chest-memory
Reference implementation (this repo)
Python lives in src/agent_memory/ (pip install -e . from the clone).
Piece | Role |
| MCP: search / add / register / inventory / sync / ingest |
| Layout engine, taxonomy, injection |
| Canonical |
| Disk vs |
| Chat catalog + extract pipeline |
| Agent install skill |
Templates only in git: examples/*.example.*. Live store: ~/.agents/memory. Run python -m agent_memory consolidate if markdown leaked into this clone.
Coding agents: follow AGENTS.md for install.
Layout (summary)
Path | What |
| Always-on identity |
| slug / path / role / stack / status |
| Cross-cutting typed memory (created on first write) |
| Link to real tree (not a copy) |
| Files only when used — staging inbox, then typed paths on write |
| Short inject; |
Search unions user + all registered project trees. Chat bodies stay in product folders; chats-index.md is titles + paths only.
Setup
Same interpreter for pip and MCP:
python -m pip install -e .
python -m agent_memory sync --init
python -m agent_memory inventoryFill ~/.agents/memory/USER.md and scan.json (from examples/*.example.* on first run). Reload your Agent after MCP merge.
See abi/PLATFORM.md for Windows symlink stubs and hardlink fallback.
Scripts
python -m agent_memory inventory
python -m agent_memory inventory --json
python -m agent_memory inventory --register SLUG "/path/to/repo" "role" "stack"
python -m agent_memory sync
python -m agent_memory --help-json
python -m agent_memory sync --help-json
python -m agent_memory inventory --help-json
python -m agent_memory ingest catalogAfter install, agent-memory on PATH is the same as python -m agent_memory.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityAmaintenanceLocal-first, file-based memory layer for AI agents — one shared Markdown vault across Claude, Codex, Gemini, Cursor and any MCP client. Provides read/write memory tools with an audit trail, per-agent trust levels, and Git sync; no cloud and no lock-in.2MIT
- Alicense-qualityBmaintenanceProvides a persistent, local-first memory for coding agents over MCP, enabling automatic recall and recording of past work, failures, and decisions to reduce repetition and token usage.MIT
- AlicenseBqualityBmaintenanceLocal-first memory server for AI coding agents that stores work sessions, tasks, and durable memories in Markdown files, exposed through MCP tools for session management and memory retrieval.10151MIT
- Alicense-qualityBmaintenanceProvides portable memory for AI agents using plain Markdown files. Enables storing, recalling, and managing memories via MCP tools like recall, remember, forget, list, and get.181MIT
Related MCP Connectors
Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Shared long-term memory vault for AI agents with 20 MCP tools.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lolaplex/agent-memory'
If you have feedback or need assistance with the MCP directory API, please join our Discord server