mcp-sessions
Allows viewing git commits made during a session, providing session diff tool.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-sessions
Search and browse Claude Code conversation history across all your projects.
Features
Cross-project search — search sessions in any project, not just the current one
Smart project resolution — use short names (
myapp), full paths, or*for all projectsFull-text search — AND-matching across sessions with snippet context
Git integration — see commits made during a session
System tag filtering — strips Claude Code internal tags from displayed content
Related MCP server: Claude Code History MCP
Tools
Tool | Description |
| List all projects with session history |
| List recent sessions (by project) |
| Full-text search with snippets |
| Find sessions mentioning a file |
| Session overview: dates, messages, files |
| Git commits during a session |
| Read raw messages from a session |
Install
git clone https://github.com/yurich-ru/mcp-sessions.git
cd mcp-sessions
chmod +x setup.sh
./setup.shThe setup script will print the JSON config to add to your ~/.claude.json.
Manual setup
python3 -m venv venv
./venv/bin/pip install -r requirements.txtAdd to ~/.claude.json:
{
"mcpServers": {
"sessions": {
"type": "stdio",
"command": "/path/to/mcp-sessions/venv/bin/python",
"args": ["/path/to/mcp-sessions/server.py"]
}
}
}Restart Claude Code.
Usage examples
From Claude Code, the tools are available automatically:
"Show my recent sessions" →
sessions_list"Search our conversations about auth" →
sessions_search(query="auth")"Find discussions about auth in project backend" →
sessions_search(query="auth", project="backend")"Search all projects for deploy issues" →
sessions_search(query="deploy", project="*")"What projects have session history?" →
sessions_projects
Environment variables
Variable | Default | Description |
|
| Directory where Claude Code stores session files |
How it works
Claude Code stores conversation history as JSONL files in ~/.claude/projects/<project-name>/. Each project directory name is derived from the filesystem path (e.g., /home/user/myapp → -home-user-myapp).
This server reads those files and provides search/browse tools via the MCP protocol.
Requirements
Python 3.10+
mcppackage (installed automatically)Claude Code (session files must exist in
~/.claude/projects/)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your versioned prompt library: search, read, save and version prompts from Claude Code.
One searchable history across every AI coding tool, with secret scanning and a shared task board.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Shared work memory for Claude Code, Codex, Cursor and chat, scoped to each repository.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving Claude Code conversation history that would otherwise expire after 30 days. Supports full-text search, semantic search, and session management with automatic backup of all conversations.28MIT
- AlicenseNot gradedqualityDmaintenanceSearch and reference your Claude Code conversation history directly from Claude, with full-text search, conversation viewing, and project browsing.MIT
- AlicenseAqualityDmaintenanceEnables Claude Code to search, browse, and read its own past conversation history across all projects using BM25 keyword search.122 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and browsing past Claude Code conversations directly from within an active Claude session, with full-text search and cost tracking.MIT