Whatsapp Summarizer

jeffrey94/jeffrey-skills

2 repo stars
Updated March 22, 2026
jeffrey94/jeffrey-skills

Transcribe WhatsApp voice notes and photos with Gemini, then summarize conversations with Claude into structured digests.

About

Whatsapp-summarizer transcribes WhatsApp voice messages and photos using Gemini, then summarizes the conversations with Claude. It supports date filtering, clarifying context, and structured summaries to make long chat threads digestible.

WhatsApp voice transcription via Gemini
Photo understanding
Claude conversation summaries
Date filtering
Structured output

Whatsapp Summarizer by the numbers

Data as of Jul 11, 2026 (Skillselion catalog sync)

/plugin marketplace add jeffrey94/jeffrey-skills

/plugin install whatsapp-summarizer@jeffrey-skills

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/jeffrey94/jeffrey-skills/whatsapp-summarizer.svg)](https://skillselion.com/skills/jeffrey94/jeffrey-skills/whatsapp-summarizer)

repo stars	★ 2
Last updated	March 22, 2026
Repository	jeffrey94/jeffrey-skills ↗

What it does

Transcribe WhatsApp voice notes and photos with Gemini, then summarize conversations with Claude into structured digests.

README.md

WhatsApp Summarizer

A Cowork plugin that transcribes WhatsApp voice messages and photos using Gemini, then summarizes conversations with Claude.

Setup

API Key

Set GEMINI_API_KEY as a shell environment variable:

export GEMINI_API_KEY="your-api-key-here"

Add it to your shell profile (~/.zshrc, ~/.bashrc, etc.) for persistence.

Dependencies

The script uses uv to manage dependencies automatically. No manual install needed. Required packages:

google-genai — Google Gemini API client

Commands

`/transcribe-chat <folder-path>`

Transcribes a WhatsApp chat export. Voice messages are transcribed and photos are described using Gemini.

Reads _chat.txt from the provided folder
Shows a date/activity preview
Asks you to confirm the date range (or trim it)
Runs Gemini transcription on all voice messages and photos
Saves transcription.md alongside the input files

`/clarify-chat <folder-path>`

Asks you clarifying questions about the transcribed conversation to build context for a better summary.

Reads transcription.md from the folder
Asks about participants, context, important topics, and desired outcomes
Saves your answers to context.md

`/summarize-chat <folder-path>`

Generates a structured summary of the conversation in English.

Reads transcription.md and context.md (if available)
Produces a summary with: Key Topics, Decisions Made, Action Items, Notable References
Saves summary.md to the same folder

Typical Workflow

# 1. Export a WhatsApp chat (include media) and unzip it

# 2. Transcribe voice messages and photos
/transcribe-chat ~/Downloads/WhatsApp\ Chat\ -\ Someone/

# 3. (Optional) Add context for a better summary
/clarify-chat ~/Downloads/WhatsApp\ Chat\ -\ Someone/

# 4. Generate the summary
/summarize-chat ~/Downloads/WhatsApp\ Chat\ -\ Someone/

Output Files

All output is written alongside the original WhatsApp export:

WhatsApp Chat - Someone/
├── _chat.txt            (original export)
├── *.opus               (original voice messages)
├── transcription.md     (from /transcribe-chat)
├── context.md           (from /clarify-chat)
└── summary.md           (from /summarize-chat)