What can you do with this server?

The mcp-session-insight server provides AI-native observability into past coding sessions from Claude Code, OpenCode, and Codex, allowing you to query, analyze, and extract insights from historical session data. * List Sessions – Browse all past sessions with optional filtering by project path and result limits * Show Session Metadata – Get a quick overview of a session (project, time, message count) using full or prefix-matched session IDs * Search Sessions – Search across all sessions by keyword in content or session ID * Get Session Summary – Retrieve a comprehensive structured JSON summary (EnrichedSummary) covering duration, message density, file changes, classified bash commands, errors, decisions, tool usage stats, and git actions — designed for LLM synthesis at zero extra API cost * Get File Changes – See which files were created or modified during a session * Get User Requests – Extract a deduplicated list of user requests made during a session * Get Todo Progress – View todo snapshots and progress tracked during a session * Get Errors & Issues – Retrieve errors encountered during a session with contextual information * Get Key Decisions – Extract important decisions made (from thinking blocks) during a session * Get Conversation History – Retrieve conversation messages with optional filtering by role (user/assistant/all) and message limit * Get Git Logs – Collect and browse git commit history across all discovered projects, with filters for date range, author, and project

Which integrations are available for this server?

Collects git commit history across all Claude Code projects, allowing filtering by date range and project.

How do I use mcp-session-insight?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-session-insight summarize my last session's file changes and errors" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-session-insight

by ArtLjn

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

MCP Session Insight

AI-Native Session Observability for Claude Code, OpenCode, and Codex

简体中文 | English

Why session-insight?

AI coding sessions accumulate rich context — file changes, user requests, decisions, errors, git history — but that context vanishes when the session ends. Static rule files cannot answer "what did I work on today?" or "what went wrong in that last session?".

session-insight gives your AI assistant a read-only lens into all past sessions:

Session analytics — extract structured insights from JSONL: file changes, decisions, errors, tool usage, todo progress
Multi-source collection — read Claude Code JSONL, OpenCode SQLite sessions, and Codex JSONL sessions
Real work filtering — Codex collection ignores developer/system prompts and environment metadata, keeping only real user work content
EnrichedSummary — returns structured JSON instead of Markdown templates, letting the calling LLM synthesize concise summaries at zero extra API cost
Cross-project git logs — collect commit history across all projects with date range, project, and author filters
Semantic classification — bash commands classified into 9 categories (build/test/deploy/debug/network/run/git/explore/other)
Session handoff — generate structured context for seamless session continuation

Related MCP server: Central Brain

Quick Start

# Install
npm install -g @morningljn/mcp-session-insight

# One-command setup
claude mcp add session-insight -- npx @morningljn/mcp-session-insight

Restart your AI assistant and it can now query all past sessions.

Supported Sources

Source	Default Location	Notes
Claude Code	`~/.claude/projects/`	Reads project-scoped JSONL sessions
OpenCode	`~/.local/share/opencode/opencode.db`	Reads SQLite session, message, and part tables
Codex	`~/.codex/sessions/`	Reads JSONL sessions and filters hidden prompts/context

Manual Setup

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "session-insight": {
      "command": "npx",
      "args": ["@morningljn/mcp-session-insight"]
    }
  }
}

Tools

Tool	Description
`collect_project_sessions`	Use first for daily reports or source-specific collection; returns source counts and structured sessions
`list_sessions`	List all sessions with optional project filter and limit
`show_session`	Show session metadata (supports prefix matching on session ID)
`search_sessions`	Search sessions by keyword in content or ID
`get_session_summary`	Returns EnrichedSummary JSON for LLM synthesis
`get_session_changes`	Get file changes (created / modified / read)
`get_session_requests`	Get deduplicated user requests
`get_session_todos`	Get todo progress snapshots
`get_session_errors`	Get errors and issues with context
`get_session_decisions`	Get key decisions from thinking blocks
`get_session_conversation`	Get conversation history with role filter
`get_git_logs`	Collect git commit logs across projects

Process Lifecycle

The server exits automatically when the MCP stdio input closes, so old Claude Code sessions should not leave orphaned npm exec or node processes behind. For an extra safety net, set SESSION_INSIGHT_IDLE_TIMEOUT_MS to a positive number of milliseconds:

{
  "mcpServers": {
    "session-insight": {
      "command": "npx",
      "args": ["@morningljn/mcp-session-insight"],
      "env": {
        "SESSION_INSIGHT_IDLE_TIMEOUT_MS": "1800000"
      }
    }
  }
}

`get_session_summary` (EnrichedSummary)

Returns structured JSON instead of formatted text. The calling LLM reads the data and synthesizes a concise summary — zero extra API cost.

{
  "sessionDuration": "116min",
  "messageDensity": "low",
  "classifiedBash": [{ "cmd": "npm test", "category": "test" }],
  "errorsWithContext": [{ "message": "...", "trigger": "Bash", "relatedFile": "src/server.ts" }],
  "fileChangeGroups": [{ "directory": "src", "created": ["git.ts"], "modified": [] }],
  "dedupedRequests": ["refactor summary to structured JSON"],
  "decisions": ["use Jaccard trigram for dedup"],
  "toolStats": { "Bash": 93, "Read": 39, "Edit": 38 },
  "gitActions": ["git commit -m \"feat: ...\"", "git push origin main"]
}

`get_git_logs`

Collect git commit history across all discovered projects:

[
  {
    "project": "/Users/user/project",
    "projectName": "my-app",
    "commits": [
      { "hash": "a1b2c3d", "message": "feat: add auth", "author": "user", "date": "2026-05-20T10:00:00+08:00", "files": ["src/auth.ts"] }
    ]
  }
]

Architecture

┌───────────────────┐   stdio    ┌──────────────────┐   read     ┌──────────────────────────┐
│   MCP Client      │◄─────────►│ session-insight  │◄──────────►│ ~/.claude/projects/      │
│ Claude/OpenCode/  │   JSON    │     server       │            │ ~/.local/share/opencode/ │
│      Codex        │           │                  │            │ ~/.codex/sessions/       │
└───────────────────┘           └───────┬──────────┘            └──────────────────────────┘
                                        │
                                 ┌──────┴──────┐
                                 │ Provider    │
                                 │ Registry    │
                                 └──────┬──────┘
                                        │
                                 ┌──────┴──────┐
                                 │  Extractor  │   Git Log
                                 │  (summary,  │   Collector
                                 │   classify, │
                                 │   dedup,    │
                                 │   errors)   │
                                 └─────────────┘

Key design decisions:

Stateless — no app-owned database, no persistence, reads existing session stores on each request
Fixture-friendly providers — provider roots are configurable so tests do not scan real local history
LLM-friendly output — structured JSON that the calling LLM synthesizes into natural language

Development

npm install
npm test        # run tests with vitest
npm run build   # compile TypeScript
npm start       # start MCP server

License

MIT

Available Tools

11 tools

get_git_logsA

Collect git commit logs across projects. Returns structured JSON grouped by project. Only call this if the user explicitly asks for git logs or commit history.

Inputs: since, until, project, author.

get_session_changesA

Get file changes (created/modified) for a session. Only call this if the user explicitly asks for file changes.

Inputs: session_id (required).

get_session_conversationB

Get conversation messages for a session

Inputs: session_id (required), role, limit.

get_session_decisionsA

Get decisions for a session. Only call this if the user explicitly asks for decisions.

Inputs: session_id (required).

get_session_errorsA

Get errors/issues for a session. Only call this if the user explicitly asks for errors.

Inputs: session_id (required).

get_session_requestsA

Get deduplicated user requests for a session. Only call this if the user explicitly asks for user requests.

Inputs: session_id (required).

get_session_summaryA

Get a comprehensive summary for a session. Returns structured JSON data (EnrichedSummary). Based on this data, synthesize a concise Chinese summary for the user covering: what was done, key files changed, errors encountered, and decisions made. This is the SINGLE tool to call when the user wants to understand what happened in a session. Do NOT call other tools after this.

Inputs: session_id (required).

get_session_todosA

Get todo snapshots for a session. Only call this if the user explicitly asks for todo progress.

Inputs: session_id (required).

list_sessionsC

List all sessions, optionally filtered by project

Inputs: project, limit.

search_sessionsC

Search sessions by keyword

Inputs: keyword (required).

show_sessionA

Show metadata for a session (project, time, message count). Use this for a quick overview. For full content, use get_session_conversation or get_session_summary.

Inputs: session_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.8/5.0

Scored 2026-05-31 16:25 across 11 tools

Disambiguation5/5

Each tool targets a distinct aspect of sessions (git logs, changes, conversation, decisions, errors, requests, summary, todos, listing, searching, metadata). Descriptions include explicit guidance on when to use each, preventing confusion.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern (e.g., get_git_logs, get_session_changes, list_sessions) using snake_case, with no deviations or mixed conventions.

Tool Count5/5

With 11 tools, the server thoroughly covers session insight without redundancy. Each tool serves a unique query, fitting the scope well.

Completeness5/5

The tool set covers all common retrieval needs for session analysis (metadata, conversation, changes, errors, decisions, etc.), with no obvious gaps for a read-only insight server.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

oneda
com.freeelatech
Persistent, governed institutional memory for Claude Code — specs, decisions, learnings.
Knowledge & Memory Documentation Access Note Taking
1
https://oneda.freeelatech.com/mcp
Memoize — persistent agent memory
io.github.harrisonford
Persistent cross-session memory shared by Codex, Claude Code, ChatGPT, and other AI agents.
Knowledge & Memory Autonomous Agents
1
https://memoize.xyz/mcp
Seturos
com.seturos
Shared work memory for Claude Code, Codex, Cursor and chat, scoped to each repository.
Knowledge & Memory Developer Tools
1
https://app.seturos.com/api/mcp
chat-recall
io.github.munhq
One searchable history across every AI coding tool, with secret scanning and a shared task board.
Knowledge & Memory Security Code Analysis
12
https://chatrecall.dev/mcp

Related MCP Servers

Memex
Knowledge & Memory RAG Systems Search
vimo-ai
A
license
Not graded
quality
D
maintenance
Enables 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.
Updated 2 months ago (2026-09-05 19:59 UTC)
6 npm
28
MIT
Central Brain
Knowledge & Memory Vector Databases AI & Machine Learning
shoyo-su
A
license
Not graded
quality
D
maintenance
Provides persistent memory for Claude Code, automatically extracting and surfacing relevant context from past sessions to avoid re-explaining issues and decisions.
Updated 8 months ago (2026-03-13 19:24 UTC)
MIT
ccfolio
Search Developer Tools Knowledge & Memory
Hippensteel
A
license
Not graded
quality
D
maintenance
Enables searching and browsing past Claude Code conversations directly from within an active Claude session, with full-text search and cost tracking.
Updated 6 months ago (2026-04-29 02:52 UTC)
MIT
context-bridge
RAG Systems Knowledge & Memory Search
zachvp
A
license
Not graded
quality
A
maintenance
Enables Claude Code to search and retrieve past chat history from Claude.ai exports and Claude Code sessions, allowing the AI to reference previous conversations and decisions.
Updated 4 months ago (2026-07-08 11:06 UTC)
MIT

MCP Session Insight

Why session-insight?

Quick Start

Supported Sources

Manual Setup

Tools

Process Lifecycle

get_session_summary (EnrichedSummary)

get_git_logs

Architecture

Development

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Memex

Central Brain

ccfolio

context-bridge

`get_session_summary` (EnrichedSummary)

`get_git_logs`