About claude-sessions
claude-sessions is an MCP server published by git+es6kr in the Developer Tools category: mCP server for managing Claude Code conversation sessions.
Install
npx claude-sessions-mcpclaude mcp add claude-code-sessions-gites6kr -- npx -y claude-sessions-mcpnpx -y claude-sessions-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (11)
clear_sessionsClear empty sessions and invalid messages
Parameters not published.
delete_messageDelete message and repair UUID chain
Parameters not published.
delete_sessionDelete session (moves to backup folder)
Parameters not published.
get_session_filesGet files changed in a session
Parameters not published.
list_projectsList Claude Code projects
Parameters not published.
list_sessionsList sessions in a project
Parameters not published.
preview_cleanupPreview sessions to be cleaned
Parameters not published.
rename_sessionRename a session
Parameters not published.
split_sessionSplit session at a specific message
Parameters not published.
start_guiStart Web UI
Parameters not published.
stop_guiStop Web UI
Parameters not published.
Ask AI
Ask AI about claude-sessions
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
claude-code-sessions
Browse, search, rename, split, and clean up Claude Code sessions — via MCP server, Web UI, or VSCode extension.
Note: This is a community project and is not affiliated with or endorsed by Anthropic.
Packages
| Package | Version | Description |
|---|---|---|
| @claude-sessions/core | Core library | |
| @claude-sessions/web | Web UI | |
| claude-sessions-mcp | MCP server | |
| claude-sessions | VSCode extension |
Installation
Stable (@latest)
# MCP Server
claude mcp add claude-sessions -- npx claude-sessions-mcp
# Web UI
npx @claude-sessions/web
Or add MCP server directly to ~/.claude.json:
{
"mcpServers": {
"claude-sessions": {
"command": "npx",
"args": ["claude-sessions-mcp"]
}
}
}
Beta (@beta)
# MCP Server
claude mcp add claude-sessions -- npx claude-sessions-mcp@beta
# Web UI
npx @claude-sessions/web@beta
Or add MCP server directly to ~/.claude.json:
{
"mcpServers": {
"claude-sessions": {
"command": "npx",
"args": ["claude-sessions-mcp@beta"]
}
}
}
Development
# Install dependencies
corepack enable
pnpm install
# Dev server
pnpm dev # Web UI
pnpm dev:mcp # MCP server
# Build
pnpm build # All packages
pnpm build:core # core only
pnpm build:mcp # mcp only
pnpm build:web # web only
Features
Project Listing
Browse Claude Code project folders with expandable tree view, sorted by summary time or name.

Session Management
List, rename, delete, and split sessions. Hover to see session details with tooltip.

Message Viewer
View messages with tab interface. Inspect user/assistant turns, tool calls, and thinking blocks.

Search
Search sessions by title across all projects.

Cleanup
Remove empty sessions, orphan agents, and orphan todos with preview before execution.

VSCode Extension

Web UI

MCP Tools
| Tool | Description |
|---|---|
list_projects |
List Claude Code projects |
list_sessions |
List sessions in a project |
rename_session |
Rename a session |
delete_session |
Delete session (moves to backup folder) |
delete_message |
Delete message and repair UUID chain |
preview_cleanup |
Preview sessions to be cleaned |
clear_sessions |
Clear empty sessions and invalid messages |
get_session_files |
Get files changed in a session |
split_session |
Split session at a specific message |
start_gui |
Start Web UI |
stop_gui |
Stop Web UI |
Tech Stack
- Core: TypeScript + Effect-TS
- MCP Server: @modelcontextprotocol/sdk
- Web UI: SvelteKit + Svelte 5 + TailwindCSS
- Build: tsup + Vite
- Package Manager: pnpm (monorepo)
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.