Agent Memory MCP

Standalone MCP server for agent-maintained memories.

Memories are stored under ~/.agents/memories by default. Set AGENT_MEMORY_ROOT to use another directory.

Install

npx -y @msr0806/agent-memory-mcp

Cursor / Claude Desktop

{
  "mcpServers": {
    "agent-memory": {
      "command": "npx",
      "args": ["-y", "--package=@msr0806/agent-memory-mcp", "agent-memory-mcp"]
    }
  }
}

If npx fails with command not found, clear the cache and retry:

npx clear-npx-cache
npx -y --package=@msr0806/agent-memory-mcp agent-memory-mcp

Optional custom storage path:

{
  "mcpServers": {
    "agent-memory": {
      "command": "npx",
      "args": ["-y", "@msr0806/agent-memory-mcp"],
      "env": {
        "AGENT_MEMORY_ROOT": "/path/to/memories"
      }
    }
  }
}

Tools

Scopes

• global — shared across all repos (e.g. coding preferences)
• repo — scoped to a repo name (e.g. project-gilly)

Storage layout

~/.agents/memories/
  global/
    coding-style/MEMORY.md
  repos/
    project-gilly/
      mvp-scope/MEMORY.md

Development

git clone https://github.com/MSR806/agent-memory-mcp.git
cd agent-memory-mcp
npm install
npm test
npm run build
npm start

Publish

npm login
npm publish --access public