Chronicle MCP Server

Local MCP server to sync, clean, and index AI chat logs locally. Saves up to 40% context tokens.

Local serverstdioPython

What is the Chronicle MCP Server?

Local MCP server to sync, clean, and index AI chat logs locally. Saves up to 40% context tokens.

What it actually does

Why · CLI Mechanics · Setup Wizard · Tool Catalog · Installation · Auto-Save · Tests · Comparison · FAQ · License

Adding it to your client

The server ships on PyPI as chronicle-mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

When to reach for it

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.

Recorded tools

  • semantic — Standard semantic retrieval using Okapi BM25 scoring with exponential temporal decay.
  • keyword — Exact string matching against terms in files.
  • date_range — Filters files modified within a date interval (requires start_date and end_date).
  • related — Finds archives semantically close to a reference file.
  • content — Message text slice within specified index ranges.
  • metadata — File statistics including message counts and modification dates.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
semanticStandard semantic retrieval using Okapi BM25 scoring with exponential temporal decay.
keywordExact string matching against terms in files.
date_rangeFilters files modified within a date interval (requires start_date and end_date).
relatedFinds archives semantically close to a reference file.
contentMessage text slice within specified index ranges.
metadataFile statistics including message counts and modification dates.

How to install the Chronicle MCP Server

{
  "mcpServers": {
    "chronicle": {
      "command": "uvx",
      "args": ["chronicle-mcp-server"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Chronicle to Non.”
  • “Use Chronicle to Linux.”
  • “Use Chronicle to Cursor.”

Frequently asked questions

Local MCP server to sync, clean, and index AI chat logs locally. Saves up to 40% context tokens. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.