# Memento MCP server

> Provides an agent memory infrastructure that enables LLMs to store, categorize, and recall information using four types of cognitive memory.

- Repository: https://github.com/jee1/memento
- Page: https://hostedmcp.org/servers/jee1/memento
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 2.3.10

## Install

### Claude Code

```sh
claude mcp add memento -- npx -y memento-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "-y",
        "memento-mcp-server"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "memento": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "memento-mcp-server"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"memento","type":"stdio","command":"npx","args":["-y","memento-mcp-server"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "-y",
        "memento-mcp-server"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add memento -- npx -y memento-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.memento]
command = "npx"
args = ["-y", "memento-mcp-server"]
```

### Gemini CLI

```sh
gemini mcp add -s user memento npx -- -y memento-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "memento": {
      "command": "npx",
      "args": [
        "-y",
        "memento-mcp-server"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DB_PATH` | no | no |  |

## FAQ

### What types of memory does Memento support?

It supports four types of cognitive memory: working, episodic, semantic, and procedural.

### How can I see all available tools in the server?

By default, only four tools are exposed. To see the full list of 22 tools, set the environment variable MEMENTO_TOOLSET=full.

### Which package manager is supported for installation?

The server only supports npm; pnpm and yarn are not supported.

### How is the memory data stored?

The memory database is stored in a file specified by the DB_PATH environment variable, typically a .db file.
