Session Logger MCP
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
- Install dependencies:
npm install- Start the MCP server:
npm startThe server will run on http://localhost:3000 by default. You can set a custom port with the PORT environment variable: ``bash PORT=8080 npm start ``
- Configure in Claude Desktop or Claude Code:
Add to your MCP settings file:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json): ``json { "mcpServers": { "session-logger": { "url": "http://localhost:3000/sse" } } } ``
Claude Code (~/.config/claude-code/mcp_config.json): ``json { "mcpServers": { "session-logger": { "url": "http://localhost:3000/sse" } } } ``
For remote access, replace localhost:3000 with your server's IP address or domain name.
- 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 todayList sessions
List my recent chat sessionsLog 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.
