Openchronicle MCP

A memory database for LLM agents. Persistent semantic + keyword memory, project namespacing, git-onboard, served over HTTP REST and MCP from a single ASGI process. Runs on your hardware. It runs locally over stdio via the published package.

People who work with hexagonal architecture, memory and self hosted and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-14 · ★ 16 · #102 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

AGPL-3.0 · Python servers · how we verify → /methodology

01 · Install Openchronicle MCP

before you install - you'll need

Set PROJECT_ID before connecting. OC_API_HOST is optional or environment-specific per the README.

Claude Code

claude mcp add carldog-openchronicle-mcp -- uvx openchronicle-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "carldog-openchronicle-mcp": {
      "command": "uvx",
      "args": [
        "openchronicle-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license AGPL-3.0 - declared in the repository

pypi package openchronicle-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry registry publisher io.github.CSOAI-ORG is not the repo owner (carldog) - the registry entry was published by someone else

03 · What Openchronicle MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.3.0 · 2026-09-01

The health-honesty release: ADR 0009 end-to-end permanent embed-failure classification, plus started-job reindexes. After redeploying, run one background backfill so over-length rows are parked as tombstones and health…

04 · Who maintains Openchronicle MCP

openchronicle-mcp is maintained by carldog. It's the only MCP server we track from this author; the repo dates to Jul 2025.

05 · Facts

repository: github.com/carldog/openchronicle-mcp
category: memory - ranked #102 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence: 1 release in the last 90 days (latest 2026-09-01)
registry: io.github.CSOAI-ORG/openchronicle-mcp (active, first published 2026-09-06)
packages: pypi:openchronicle-mcp

06 · Openchronicle MCP FAQ

What is Openchronicle MCP?

Is Openchronicle MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-14 and it shipped 1 release in the last 90 days. We re-verify nightly.

How do I install Openchronicle MCP?

Run `uvx openchronicle-mcp`. The README documents 2 environment variables (PROJECT_ID, OC_API_HOST) to set first. Set PROJECT_ID before connecting. OC_API_HOST is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Openchronicle MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Openchronicle MCP

Alternatives to Openchronicle MCP

Maintained memory servers if Openchronicle MCP isn't the fit.

Pairs well with

Servers that cover what Openchronicle MCP doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Memorydetective · Hypermnesia MCP · Hypermnesia MCP Viz · Remembrall MCP · Memory MCP (chenxiaofie)

More Python MCP servers · Leadenrich MCP · Oh My Cassette · Nyc Property Intel · Futuristic Risk Intelligence · see all