Chatlog Summary Tool

A modular tool for summarizing chat records using MCP (Model Context Protocol) tools and AI API. The tool analyzes chat conversations and extracts key information in a structured JSON format.

Features

• General-purpose chat analysis: Extract main topics, key conversations, decisions, and action items
• JSON output: Structured data format for further processing
• Multi-contact support: Combine and analyze multiple contacts (groups/chats) simultaneously
• Flexible date handling: Single dates, date ranges, or daily summaries
• Batch processing: Summarize multiple contacts and date ranges
• Modular design: Easy to extend and customize

Usage

First, you need to start the chatlog mcp server first, for details, please refer to https://github.com/sjzar/chatlog

$ export ARK_API_KEY=your_api_key

python chatlog_summary.py "ContactName" [date] [options]

Single Contact Examples

# Summarize today's chat with John
python chatlog_summary.py "John"

# Summarize specific date
python chatlog_summary.py "John" 2025-04-27

# Summarize date range
python chatlog_summary.py "John" 2025-04-25:2025-04-27

# Generate daily summaries for date range
python chatlog_summary.py "John" 2025-04-25:2025-04-27 --daily

Multi-Contact Examples

# Summarize today's chat from multiple groups/contacts
python chatlog_summary.py "Group1,Group2"

# Summarize multiple contacts on specific date
python chatlog_summary.py "John,Jane" 2025-04-27

# Multi-contact date range summary
python chatlog_summary.py "Group1,Group2,Group3" 2025-04-25:2025-04-27

# Daily summaries for multiple teams
python chatlog_summary.py "TeamA,TeamB" --from 2025-04-25 --to 2025-04-27 --daily

Utility Commands

# List available contacts
python chatlog_summary.py --list-contacts

# Batch summarize past week
python chatlog_summary.py --batch-week

Output

The tool generates JSON files with structured chat analysis including:

• Main discussion topics
• Key conversations with original text
• Important decisions and action items
• Overall summary
• Participant information
• Media statistics
• AI analysis insights

Multi-Contact Output

When using multi-contact mode, the tool:

• Combines chat records from all specified contacts
• Clearly separates content by contact/group in the analysis
• Generates files with multi_ prefix (e.g., multi_Group1_Group2_2025-04-27.json)
• Provides comprehensive cross-contact analysis and insights

generate markdown files

python3 markdown_generator.py

python3 markdown_generator.py --help

python3 markdown_generator.py --file filename.json

python3 markdown_generator.py --separate

Acknowledgement

• chatlog

License

MIT License

Sponsored by

• https://bio.site/italianbrainrot
• https://bio.site/image2text