Claude Historian

by Vvkmnn

334 downloads
Not rated
GitHub

About

claude-historian - an MCP server that gives Claude access to your your previous messages and conversations.

Details

Author
Vvkmnn
Downloads
334
Categories
AI

- Search Claude chat history locally instead of scrolling.
- No external servers, sign-ins, or data collection.
- All data stays on your machine.
- Works with local JSONL Claude Code files.
- Quickly find past solutions, error fixes, and file changes.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Claude Historian
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

After adding the server to your MCP configuration, Claude can automatically search your local JSONL chat history files. You simply ask Claude about a past conversation, and the server fetches the relevant messages from the stored files on your machine.

search_conversations

Search through Claude Code conversation history

find_file_context

Find conversations related to a specific file

find_similar_queries

Find previous similar questions or queries

get_error_solutions

Find how similar errors were resolved in the past

list_recent_sessions

List recent conversation sessions

extract_compact_summary

Get a compact summary of a conversation session

find_tool_patterns

Find patterns of successful tool usage

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "claude historian": {
            "claude-historian": {
                "command": "npx",
                "args": [
                    "claude-historian"
                ],
                "env": []
            }
        }
    }
}

McpServers

{
    "claude-historian": {
        "command": "npx",
        "args": [
            "claude-historian"
        ],
        "env": []
    }
}

claude-historian - an MCP server that gives Claude access to your your previous messages and conversations.

I got tired of guessing with claude --resume, so far I use it every day (today). Also my first MCP project , so open to feedback or PRs.

What it can do:
• ⁠Search your Claude chat history instead of scrolling forever.
• ⁠Find solutions, error fixes, file changes from weeks ago.
• ⁠Wear shades: [⌐■_■]

How it works:
• ⁠Scans local
JSONL` Claude Code files
• ⁠No external servers, sign-ins, or data collection
• ⁠Everything stays on your machine

When to use:
⁠"How did I fix that auth bug last month"
• ⁠"What was that Docker command I used"
• ⁠*"Did I ask about React hooks before"

GitHub: https://github.com/Vvkmnn/claude-historian
NPM: https://www.npmjs.com/package/claude-historian

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.