# SuperLocalMemory MCP server

> Lets AI agents remember, govern, and recall decisions, documents, and screenshots in local memory with cited, honest answers.

- Repository: https://github.com/qualixar/superlocalmemory
- Page: https://hostedmcp.org/servers/qualixar/superlocalmemory
- Transport: stdio
- Stars: 277
- License: AGPL-3.0
- Latest version: 4.2.19

## Install

### Claude Code

```sh
claude mcp add superlocalmemory -- uvx superlocalmemory
```

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

```json
{
  "mcpServers": {
    "superlocalmemory": {
      "command": "uvx",
      "args": [
        "superlocalmemory"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "superlocalmemory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "superlocalmemory"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"superlocalmemory","type":"stdio","command":"uvx","args":["superlocalmemory"]}'
```

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

```json
{
  "mcpServers": {
    "superlocalmemory": {
      "command": "uvx",
      "args": [
        "superlocalmemory"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add superlocalmemory -- uvx superlocalmemory
```

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

```toml
[mcp_servers.superlocalmemory]
command = "uvx"
args = ["superlocalmemory"]
```

### Gemini CLI

```sh
gemini mcp add -s user superlocalmemory uvx -- superlocalmemory
```

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

```json
{
  "mcpServers": {
    "superlocalmemory": {
      "command": "uvx",
      "args": [
        "superlocalmemory"
      ]
    }
  }
}
```

## Tools (5)

- `core`
- `code`
- `mesh`
- `power`
- `whole`

## FAQ

### Does SuperLocalMemory work without an API key or cloud account?

Yes. In Mode A, core remember and recall run with no model-provider call, so no API key, cloud account, or Docker is needed.

### What happens when my agent asks something not in memory?

It returns one of three tiers, and for nonsense or unknown questions it plainly says the answer isn't in SuperLocalMemory instead of guessing.

### Can I search screenshots and PDFs by describing them?

Yes, if pictures and documents are enabled. A local model indexes images and PDF pages, and answers cite the file and page.

### Can multiple agents share one memory?

Yes. Every write records which agent made it, with trust scores to guard against memory poisoning.

### How do I install SuperLocalMemory?

Install via npm, pip, or uv, then run setup and connect your agent. An agent-guided install prompt and a one-line shell script are also offered.