# LoreConvo MCP server

> Provides local-first persistent session memory for AI agents using SQLite and FTS5 to carry context across different coding environments.

- Repository: https://github.com/labyrinth-analytics/loreconvo
- Page: https://hostedmcp.org/servers/labyrinth-analytics/loreconvo
- Transport: stdio
- Stars: 12
- Latest version: 0.11.0

## Install

### Claude Code

```sh
claude mcp add --env 'LORECONVO_PRO=<YOUR_LORECONVO_PRO>' loreconvo -- uvx loreconvo
```

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

```json
{
  "mcpServers": {
    "loreconvo": {
      "command": "uvx",
      "args": [
        "loreconvo"
      ],
      "env": {
        "LORECONVO_PRO": "<YOUR_LORECONVO_PRO>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "loreconvo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "loreconvo"
      ],
      "env": {
        "LORECONVO_PRO": "<YOUR_LORECONVO_PRO>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"loreconvo","type":"stdio","command":"uvx","args":["loreconvo"],"env":{"LORECONVO_PRO":"<YOUR_LORECONVO_PRO>"}}'
```

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

```json
{
  "mcpServers": {
    "loreconvo": {
      "command": "uvx",
      "args": [
        "loreconvo"
      ],
      "env": {
        "LORECONVO_PRO": "<YOUR_LORECONVO_PRO>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add loreconvo --env 'LORECONVO_PRO=<YOUR_LORECONVO_PRO>' -- uvx loreconvo
```

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

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

[mcp_servers.loreconvo.env]
LORECONVO_PRO = "<YOUR_LORECONVO_PRO>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'LORECONVO_PRO=<YOUR_LORECONVO_PRO>' loreconvo uvx -- loreconvo
```

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

```json
{
  "mcpServers": {
    "loreconvo": {
      "command": "uvx",
      "args": [
        "loreconvo"
      ],
      "env": {
        "LORECONVO_PRO": "<YOUR_LORECONVO_PRO>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `LORECONVO_PRO` | no | yes | Pro license key. Leave unset for the free tier. |

## Tools (40)

- `save_session`
- `get_recent_sessions`
- `get_session`
- `search_sessions`
- `get_context_for`
- `tag_session`
- `link_sessions`
- `get_related_sessions`
- `create_project`
- `get_project`
- `list_projects`
- `get_skill_history`
- `vault_suggest`
- `get_tier`
- `vault_set_tier`
- `export_sessions`
- `import_sessions`
- `consolidate_memories`
- `get_memory_digest`
- `set_session_expiry`
- `get_stats`
- `inspect_sessions`
- `export_for_anthropic`
- `rebuild_index`
- `rebuild_index_status`
- `loreconvo_onboard`
- `get_dream_log`
- `get_docs_for_session`
- `session_link_doc`
- `pin_session`
- `get_anti_patterns`
- `tag_as_anti_pattern`
- `untag_anti_pattern`
- `save_memory_item`
- `query_memory_items`
- `transition_memory_item`
- `update_memory_item`
- `configure_agent_context`
- `inject_agent_context`
- `graph_session_map`

## FAQ

### Where is my data stored?

Your data is stored locally in a SQLite database on your own machine at ~/.loreconvo/sessions.db.

### Does LoreConvo work with Cursor and Claude Code?

Yes, it works across multiple clients including Claude Code, Cowork, Cursor, Codex, and Hermes Agent.

### Can I use it with the Claude web interface?

While the web interface doesn't support plugins directly, you can use a provided script to export your session to your clipboard for pasting into Chat.

### What kind of memory does it capture?

It captures episodic memory (summaries, artifacts, and open questions) and semantic memory (stable project conclusions).
