Skip to main content
Glama
es6kr

claude-sessions-mcp

by es6kr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

claude-code-sessions

License: MIT Unofficial

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

npm

Core library

@claude-sessions/web

npm

Web UI

claude-sessions-mcp

npm

MCP server

claude-sessions

VS MarketplaceOpen VSX

VSCode extension

Related MCP server: claude-code-mcp

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.

Project Listing

Session Management

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

Session Management

Message Viewer

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

Message Viewer

Search

Search sessions by title across all projects.

Search

Cleanup

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

Cleanup

VSCode Extension

VSCode Extension

Web UI

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessSlow

Resources

Related MCP Connectors

Related MCP Servers

  • Session Buddy

    lesleslie
    A
    license
    A
    quality
    B
    maintenance
    Provides comprehensive session management for Claude Code with automatic initialization/cleanup, quality checkpoints, and local conversation memory with semantic search for capturing learnings across coding sessions.
    6
    631 PyPI
    2
    BSD 3-Clause

  • claude-code-mcp

    xihuai18
    A
    license
    A
    quality
    D
    maintenance
    Wraps Claude Code as tools for MCP clients, enabling autonomous coding tasks via a 4-tool lifecycle with session management, async polling, and permission controls.
    4
    34 npm
    20
    MIT

  • claude-replay

    constripacity
    A
    license
    A
    quality
    A
    maintenance
    Enables search, analytics, and visualization of Claude Code sessions with MCP tools for session management, recovery, and insights.
    10
    1
    MIT