feat: add claude-history-mcp to community extensions

[sydasif]

Adds claude-history-mcp as a community extension in the README.

This MCP server lets Claude Code query its own session history — search messages, list sessions, retrieve transcripts, and analyze usage patterns across all your projects.

Key features:

• Reads from ~/.claude/projects/**/*.jsonl (session transcripts) and ~/.claude/history.jsonl (command history)
• Caches data in a local SQLite database with incremental mtime tracking
• Exposes 7 MCP tools and 2 resources via FastMCP (stdio transport)
• Natural language date filtering ("yesterday", "last week", etc.)
• Install: claude mcp add claude-history --scope user -- uvx --from git+https://github.com/sydasif/claude-history-mcp claude-history-mcp

Summary by CodeRabbit

• Documentation
  • Updated the Community Extensions section to include claude-history-mcp.
  • Added details on its transcript/history input locations, local SQLite caching with incremental tracking, and the number of FastMCP tools and resources available.
  • Adjusted the related projects listing formatting and updated the TODO item formatting for GitHub Actions.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c803b90b-ec31-4c57-8ea3-7e28f8499998

📥 Commits

Reviewing files that changed from the base of the PR and between 053f17a and 27f31a3.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

README.md restructures the Community Extensions project list, adds a claude-history-mcp related-project entry with its data sources and MCP capabilities, and updates the wording and formatting of one TODO item.

Changes

README documentation

Layer / File(s)	Summary
Community extension and TODO updates README.md	Adds claude-history-mcp details covering transcript inputs, SQLite caching, and FastMCP tools/resources; updates the GitHub Actions import TODO entry.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

• daaain/claude-code-log#120: Both PRs modify the README’s Community Extensions section.

Suggested reviewers: daaain

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: adding claude-history-mcp to the README’s extensions/projects listing.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 307: Update the TODO entry in the README list to use the repository’s
established list-item marker instead of an indented en dash, and capitalize
“GitHub” in the item text.
- Line 298: Update the README install command to pin sydasif/claude-history-mcp
to a reviewed commit SHA instead of the default branch, and add a brief
trust/privacy note explaining that this MCP reads session transcripts and
command history.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d61414ba-caa0-4fde-a820-f816da89f93b

📥 Commits

Reviewing files that changed from the base of the PR and between fa10afb and f1ef713.

📒 Files selected for processing (1)

• README.md

[cboos]

Neat! But that project doesn't seem to use anything from us, so I don't see how this could be categorized as a "community extension." Can you enlighten us?

[daaain]

Looks like the project is based off the code from this library with a lot of functionality removed: https://github.com/sydasif/claude-history-mcp/blob/0d02f02472170690453ab0c3210b1012023c680f/spec.md#16-what-we-skip-vs-claude-code-log

The idea is good and considered doing something similar myself, but not sure if promoting it in the top level README is quite warranted as is, since your library basically took a snapshot and won't get bug fixes and improvements.

If you'd be up for redoing with this library as the parser, we could consider doing a cache refresh only mode in the CLI if that's what was stopping you?

[sydasif]

Thanks for the feedback @cboos and @daaain! You're absolutely right - the current version was a snapshot that doesn't benefit from upstream improvements.

I've addressed this by creating PR #292 which adds a public library API (claude_code_log.api) to claude-code-log. Once that's merged, claude-history-mcp will depend on the library directly:

• Uses claude_code_log.api.load_transcript() / load_directory_transcripts() for parsing
• Uses claude_code_log.api.CacheManager / SessionCacheData for caching
• Gets bug fixes and improvements automatically

The library API PR (#292) is open and passing all CodeRabbit checks. Once merged, I'll update the dependency and this PR will represent a true "community extension" that properly integrates with the ecosystem.

Also noted on the "cache refresh only mode" - that would be a great addition for the CLI. Happy to contribute that once the library API is merged.

Also noted on the "cache refresh only mode" - that would be a great addition for the CLI. Happy to contribute that once the library API is merged.

Also noted on the "cache refresh only mode" - that would be a great addition for the CLI. Happy to contribute that once the library API is merged.

Happy to adjust the README categorization once the library integration is complete!

[sydasif]

Thanks.