Local MCP server to sync, clean, and index AI chat logs locally. Saves up to 40% context tokens.
Local MCP server to sync, clean, and index AI chat logs locally. Saves up to 40% context tokens. The chronicle mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.
Why · CLI Mechanics · Setup Wizard · Tool Catalog · Installation · Auto-Save · Tests · Comparison · FAQ · License
Everything the assistant can do here goes through one of these:
Non — TTY/Subprocesses**: Launches the stdio transport server for MCP clientsLinux — Follows the XDG base directory specification, resolving to ~/.config/Cursor — Reads and writes configurations to ~/.cursor/mcp.jsonmacOS — ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonWindows — %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonTrae — Resolves configuration to:Description — Unified search and filter interface for local chat transcripts. Supports keyword, Okapi BM25 semantic, date range, and related chat lookupsParameters — * query (str, default: ""): The search query string or keywords listsemantic — Standard semantic retrieval using Okapi BM25 scoring with exponential temporal decaykeyword — Exact string matching against terms in filesdate_range — Filters files modified within a date interval (requires start_date and end_date)related — Finds archives semantically close to a reference fileThe 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.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Chronicle's toolset — Non, Linux, Cursor and 11 more — is a fair guide to whether it matches your workflow. It is maintained by Leviathan0x0; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Chronicle's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Non | TTY/Subprocesses**: Launches the stdio transport server for MCP clients. |
| Linux | Follows the XDG base directory specification, resolving to ~/.config/. |
| Cursor | Reads and writes configurations to ~/.cursor/mcp.json. |
| macOS | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Windows | %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Trae | Resolves configuration to: |
| Description | Unified search and filter interface for local chat transcripts. Supports keyword, Okapi BM25 semantic, date range, and related chat lookups. |
| Parameters | * query (str, default: ""): The search query string or keywords list. |
| 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. |
{
"mcpServers": {
"chronicle": {
"command": "uvx",
"args": ["chronicle-mcp-server"]
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.