# openchronicle-mcp

Keeps agent memories across sessions with semantic and keyword search. Useful when project decisions must remain available after context changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: CarlDog
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/CarlDog/openchronicle-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/openchronicle-mcp

## What it does

openchronicle-mcp stores decisions, milestones, and discarded approaches so an agent can retrieve them later. Each project gets its own memory scope, while search combines full-text matching with semantic ranking. It can also inspect a Git repository and turn related commit history into material for long-term memory.

A single ASGI process exposes both a REST API and the MCP HTTP transport. The database stays on your hardware, with versioned schema changes, verified SQLite backups, and optional encrypted copies sent through age and rclone. If the embedding service fails, searches fall back to FTS5 and report the degraded state.

A container needs `OC_API_HOST=0.0.0.0`; otherwise the application binds only inside the container and the published port cannot reach it. Source installation requires Python 3.14+ with `.[mcp,openai]`; Claude Code connects over `http://127.0.0.1:8000/mcp`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add openchronicle-mcp -- uvx openchronicle-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from openchronicle-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add openchronicle-mcp -- uvx openchronicle-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from openchronicle-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openchronicle-mcp": {
            "command": "uvx",
            "args": [
                "openchronicle-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from openchronicle-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openchronicle-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "openchronicle-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from openchronicle-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add openchronicle-mcp uvx openchronicle-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from openchronicle-mcp <command>

## When to use it
- preserve agent decisions across sessions
- isolate memories by project
- search records by meaning and keywords
- turn Git history into project memory
- create verified SQLite backups

## Example prompts
- Save the SQLite storage decision with the `decision` tag using `memory_save`.
- Use `memory_search` to find the project’s earlier storage decisions.
- Inspect this repository’s Git history and prepare material for long-term memory.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md