# Memory Kernel MCP server

> Provides a local-first memory layer for AI agents using SQLite FTS5 to store, search, and manage structured memories without a vector database.

- Repository: https://github.com/Artem362/memory-kernel
- Page: https://hostedmcp.org/servers/artem362/memory-kernel
- Transport: stdio
- Stars: 3
- License: Apache-2.0
- Latest version: 0.3.2

## Install

### Claude Code

```sh
claude mcp add memory-kernel -- uvx amormorri-memory-kernel
```

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

```json
{
  "mcpServers": {
    "memory-kernel": {
      "command": "uvx",
      "args": [
        "amormorri-memory-kernel"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "memory-kernel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "amormorri-memory-kernel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memory-kernel": {
      "command": "uvx",
      "args": [
        "amormorri-memory-kernel"
      ]
    }
  }
}
```

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

```toml
[mcp_servers.memory-kernel]
command = "uvx"
args = ["amormorri-memory-kernel"]
```

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

```json
{
  "mcpServers": {
    "memory-kernel": {
      "command": "uvx",
      "args": [
        "amormorri-memory-kernel"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MEMORY_KERNEL_DB` | no | no | Path to the SQLite database file (defaults to .memory-kernel/memory.db in the working directory) |

## FAQ

### What is the difference between delete and forget?

The delete command removes a memory permanently, while forget performs a soft-archive that hides the memory from recall but keeps the data for later restoration.