# 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

```sh
npx -y @msr0806/agent-memory-mcp
```

## Cursor / Claude Desktop

```json
{
  "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:

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

Optional custom storage path:

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

## Tools

| Tool | Description |
|------|-------------|
| `create_memory` | Create a global or repo-scoped memory |
| `read_memory` | Read one memory |
| `read_memories` | Read global + repo memories for a repo |
| `update_memory` | Update description and/or content |
| `delete_memory` | Delete a memory |
| `list_memories` | List memory metadata |

### 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

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

## Publish

```sh
npm login
npm publish --access public
```