claude-session-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_projectsA | List all Claude Code projects that have session history. Returns project slugs (derived from directory paths), session counts, and total size. |
| list_sessionsA | List sessions for a project, sorted by most recent first. Args: project: Project slug to filter by. Empty for all projects. limit: Maximum sessions to return (default 20). offset: Skip first N sessions for pagination. |
| searchA | Full-text search across Claude Code session history. Searches conversation text (user and assistant messages) with fork awareness. Returns matches with surrounding conversational context and branch info. Args: query: Search text (case-insensitive substring match). project: Project slug to filter by. Empty for all projects. max_results: Maximum results (default 10, max 50). include_subagents: Also search subagent session files. |
| get_treeA | Get the conversation tree structure for a session. Shows fork points, branch summaries, compaction boundaries, and leaf nodes. Use this to understand the structure before navigating with get_thread or get_forks. Args: session_id: Session UUID (or prefix). project: Optional project slug to narrow lookup. |
| get_threadA | Get a conversation thread (root-to-leaf path through the tree). Only includes user and assistant messages. Supports pagination for long threads. Args: session_id: Session UUID (or prefix). leaf_uuid: UUID of the leaf node. Empty for the primary (latest) thread. project: Optional project slug. offset: Skip first N messages for pagination. limit: Max messages to return (default 50, max 200). include_tool_calls: Show tool names used in assistant messages. |
| get_forksA | Get fork points in a session with diverging branch details. Shows where conversations branched (retries, edits) and which branch the user continued with (primary) vs abandoned. Args: session_id: Session UUID (or prefix). project: Optional project slug. fork_uuid: Show only this specific fork point. Empty for all forks. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct focus: listing projects, listing sessions, full-text search, tree structure, thread retrieval, and fork details. get_tree and get_forks are complementary per the descriptions, with get_tree explicitly positioned as a precursor to get_thread and get_forks. No two tools appear to perform the same action.
Names follow a predictable verb_noun pattern for most tools (list_projects, list_sessions, get_tree, get_thread, get_forks). The 'search' tool deviates by lacking an explicit object, but this is minor and does not cause confusion. Overall, the naming is readable and consistent in style.
Six tools is well within the ideal range for a focused session-history viewer. Each tool covers a necessary aspect of the domain without redundancy or bloat. The count feels appropriately scoped for the server's purpose.
The tool surface covers the full read-only lifecycle of exploring session history: discover projects, list sessions, search across content, inspect the conversation tree, retrieve specific threads, and analyze forks. No obvious gaps are apparent for the stated purpose.