What can you do with this server?

The claude-sessions-mcp server manages Claude Code project sessions and chat history through MCP tools and a web interface. Core Features: * Project Management: List all Claude Code projects with session counts * Session Operations: List, rename (via title prefixes), and delete sessions (safely moved to .bak folder for recovery) * Message Management: Delete individual messages with automatic UUID chain repair * Cleanup Operations: Preview and execute bulk cleanup to remove empty sessions, invalid API key sessions, and orphaned agent files * File Tracking: Get lists of files changed in sessions and view diff summaries with snapshot information * Web Interface: Start/stop a SvelteKit-based GUI (default port 5173) with auto-open browser, providing visual management of projects, sessions, conversation history, inline editing, and bulk cleanup operations

How do I use claude-sessions-mcp?

1. Click on "Install 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., "@claude-sessions-mcp list my recent Claude Code sessions" 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.

The claude-sessions-mcp server manages Claude Code project sessions and chat history through MCP tools and a web interface.

Core Features:

Project Management: List all Claude Code projects with session counts
Session Operations: List, rename (via title prefixes), and delete sessions (safely moved to .bak folder for recovery)
Message Management: Delete individual messages with automatic UUID chain repair
Cleanup Operations: Preview and execute bulk cleanup to remove empty sessions, invalid API key sessions, and orphaned agent files
File Tracking: Get lists of files changed in sessions and view diff summaries with snapshot information
Web Interface: Start/stop a SvelteKit-based GUI (default port 5173) with auto-open browser, providing visual management of projects, sessions, conversation history, inline editing, and bulk cleanup operations

claude-sessions-mcp

MCP (Model Context Protocol) server and Web UI for managing Claude Code sessions.

Features

Project Listing: Browse Claude Code project folders
Session Management: List, rename, and delete sessions
Message Management: View and delete messages within sessions
Cleanup: Clear empty sessions and remove invalid API key messages
Web UI: SvelteKit-based web interface

Installation

# Using npx (recommended) npx claude-sessions-mcp # Or install globally npm install -g claude-sessions-mcp

Usage

Claude Code MCP Integration

Add to Claude Code:

claude mcp add claude-sessions -- npx claude-sessions-mcp

Or manually edit ~/.claude.json:

{ "mcpServers": { "claude-sessions": { "command": "npx", "args": ["claude-sessions-mcp"] } } }

Web GUI

Launch the web interface via MCP tool (from Claude Code):

> Use the start_gui tool to launch web interface

The GUI opens at http://localhost:5050 with features:

Browse all projects and sessions
View full conversation history
Rename sessions with inline editing
Delete unwanted sessions
Bulk cleanup of empty sessions

Development

# Enable corepack corepack enable # Install dependencies pnpm install # Start web development server pnpm dev # MCP server development mode pnpm dev:mcp

Build

pnpm build

MCP Server Tools

Available Tools

Tool	Description
`list_projects`	List Claude Code projects
`list_sessions`	List sessions in a project
`rename_session`	Rename a session
`delete_session`	Delete a session (moves to backup folder)
`delete_message`	Delete a message and repair UUID chain
`preview_cleanup`	Preview sessions to be cleaned
`clear_sessions`	Clear empty sessions and invalid messages
`start_gui`	Start the web UI
`stop_gui`	Stop the web UI

Tech Stack

MCP Server: Node.js + TypeScript + Effect
Web UI: SvelteKit + Svelte 5
Build: tsup (MCP), Vite (Web)
Package Manager: pnpm (corepack)

Effect-TS Patterns

This project uses Effect for functional async operations:

import { Effect, pipe, Array as A, Option as O } from 'effect' // Define an Effect (lazy, composable) const listProjects = Effect.gen(function* () { const files = yield* Effect.tryPromise(() => fs.readdir(dir)) return files.filter((f) => f.endsWith('.jsonl')) }) // Parallel execution with concurrency control const results = yield * Effect.all( items.map((item) => processItem(item)), { concurrency: 10 } ) // Option for nullable values const title = pipe( messages, A.findFirst((m) => m.type === 'user'), O.map((m) => extractTitle(m)), O.getOrElse(() => 'Untitled') ) // Run in SvelteKit endpoint export const GET = async () => { const result = await Effect.runPromise(listProjects) return json(result) }

License

MIT

claude-sessions-mcp

claude-sessions-mcp

Features

Installation

Usage

Claude Code MCP Integration

Web GUI

Development

Build

MCP Server Tools

Available Tools

Tech Stack

Effect-TS Patterns

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API