Session Logger

An MCP server that saves and queries LLM chat conversations to structured log files.

Features

• save_conversation: Save the current conversation to a JSONL log file
• query_logs: Search saved conversations by session ID, user ID, keyword, or date range
• list_sessions: View all saved sessions with summary information

Installation

1. Install dependencies:

npm install

2. Start the MCP server:

npm start

The server will run on http://localhost:3000 by default. You can set a custom port with the PORT environment variable:

PORT=8080 npm start

3. Configure in Claude Desktop or Claude Code:

Add to your MCP settings file:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "session-logger": {
      "url": "http://localhost:3000/sse"
    }
  }
}

Claude Code (~/.config/claude-code/mcp_config.json):

{
  "mcpServers": {
    "session-logger": {
      "url": "http://localhost:3000/sse"
    }
  }
}

For remote access, replace localhost:3000 with your server's IP address or domain name.

4. Restart Claude Desktop or Claude Code

Usage

Save a conversation

Simply ask Claude:

Save this conversation

Claude will use the save_conversation tool to log the entire conversation to a JSONL file.

Query logs

Search my logs for conversations about "python"

Show me all sessions from today

List sessions

List my recent chat sessions

Log Storage

Logs are stored in: ~/.session-logger-mcp/logs/

Format: YYYY-MM-DD.jsonl

Each log entry contains:

• timestamp
• session_id
• user_id (if provided)
• role (user/assistant)
• message content
• token count
• model info
• metadata

Log Rotation

Log files automatically rotate when they exceed 10MB.