MCP SERVERLoad a cheap memory index at the start of a session, search it by substring for one fact, and leave a session summary that a background daemon later distils into durable memories.
LABSCO SUMMARY
memory_read with no arguments returns only the index; a topic's full content comes back when you name it, and memory_search pulls a single fact without dragging the rest in with it. Writing is deferred rather than immediate — memory_append_session stores a summary and the daemon distils it afterwards, which is why the tool asks for durable findings and decisions at 300-800 tokens rather than a play-by-play, since a longer summary costs more at consolidation. If the daemon is not running, summaries keep accumulating and nothing turns them into memories.
A file-backed agent memory: a MEMORY.md index, topic files behind it, and a sessions directory that a consolidation daemon reads.
MEMORY_DIRECTORY and SESSION_DIRECTORY, the directories the index and the session summaries live in. The consolidation daemon, for summaries to become durable memories — memory_daemon_status is how you find out whether it is there.
Follow the published steps — npm install -g mcp-agent-memory
USE CASES
The index loads on its own and costs little; a topic file is pulled only when it is named, and a single fact is found by substring without loading anything around it.
The summary is appended at the end of a meaningful exchange and the daemon extracts durable memories from it later, which is why it asks for findings and decisions at 300-800 tokens rather than a play-by-play.
Summaries accumulate whether or not anything consolidates them, so the daemon's state is the first thing to check when the index stops growing.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
memory_append_sessionAppend a session summary to the sessions directory. The daemon will later extract durable memories from it. Call this at the end of meaningful exchanges. Keep summaries focused on durable findings and decisions (target 300-800 tokens), not play-by-play — longer summaries cost more during consolidation.
memory_daemon_statusCheck whether the memory consolidation daemon is running. Reports if the daemon is not installed or not available on this platform.
memory_readRead the agent memory index (MEMORY.md) and optionally specific topic files. Call with no arguments to load only the lightweight index (cheap). Pass topics only when you need the full content of a specific topic file.
memory_searchSearch memory files for a substring. Use this to recall specific facts without loading everything.
BEFORE YOU INSTALL
4 tools when we connected. memory_daemon_status is available but undocumented.
npx on PATH
All 3 documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npm install -g mcp-agent-memory
mcp-agent-memory --setup{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"mcp-agent-memory"
],
"env": {
"MEMORY_DIRECTORY": "~/.agent-memory/memory",
"SESSION_DIRECTORY": "~/.agent-memory/sessions"
},
"disabled": false,
"timeout": 30000,
"autoApprove": [
"memory_read",
"memory_search",
"memory_append_session",
"memory_daemon_status"
]
}
}
}{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"mcp-agent-memory"
],
"env": {
"MEMORY_DIRECTORY": "~/.agent-memory/memory",
"SESSION_DIRECTORY": "~/.agent-memory/sessions"
},
"autoApprove": [
"memory_read",
"memory_search",
"memory_append_session",
"memory_daemon_status"
]
}
}
}MCP servers
nhadaututtheky
Yuchen20
tstockham96
djm81