Claude Viewer

Queries Claude Code history data via MCP to view users, conversations, stats, and transcripts.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "maxturazzini-claude-viewer": {
      "command": "node",
      "args": [
        "/path/to/claude-viewer/mcp-server.js"
      ]
    }
  }
}

Claude Viewer exposes conversation data from Claude Code history to MCP clients. It lets you query users, conversations, and detailed transcripts, then visualize and analyze them from a single MCP-enabled interface on your machine.

How to use

You connect an MCP client to Claude Viewer to fetch conversation data and drive dashboards, searches, and detail views. Use the available MCP tools to list users, retrieve conversations with filters, view statistics, get full transcripts, and open the dashboard. You can open the dashboard directly from Claude when you start the MCP server, then browse conversations, inspect individual threads, and export data for further analysis.

How to install

Prerequisites: Node.js and npm must be installed on your system.

Clone or download Claude Viewer and navigate to the project directory.

Install dependencies.

# Clone or download the project
 git clone https://example.com/maxturazzini/claude-viewer.git
 cd claude-viewer

# Install dependencies
 npm install

# Start the MCP server directly (stdio transport)
 node mcp-server.js

# Or start via the npm script
 npm run mcp

Configuration and usage notes

Start port defaults to 2204. You can override the port by setting CLAUDE_VIEWER_PORT before starting the server.

Two explicit ways to run the MCP server are provided in the project workflow.

# Run MCP server (stdio transport)
npm run mcp

# Or directly
node mcp-server.js

Troubleshooting and tips

If the dashboard does not display data, verify that the history and project JSONL files exist in your Claude data locations, and check server logs for errors.

If the port is in use, either stop the existing process or start on a different port by setting CLAUDE_VIEWER_PORT.

MCP tools exposed by Claude Viewer

get_claude_users              List users with Claude history
get_conversations             Get conversations with filters
get_stats                     Aggregated usage statistics
get_conversation_details      Full transcript of a session
open_dashboard                Start server and open browser

Available tools

get_claude_users

Lists users who have Claude history available on the system.

get_conversations

Retrieves conversations with optional filters such as username, project, date range, and text search.

get_stats

Returns aggregated usage statistics like total conversations, tokens, and top models/tools.

get_conversation_details

Fetches the full transcript of a specific session for detailed viewing.

open_dashboard

Launches the dashboard UI in your browser and starts the server if needed.