email-meeting-summary

Email Meeting Summary

Read a Google Meet transcript, identify discussion topics, summarize decisions and action items for the chosen topic, and compose a Gmail draft for review.

Prerequisites

• gws binary must be on $PATH
• Authenticated: run gws auth login if not already logged in. The --readonly flag is sufficient for reading calendar/docs/drive, but draft creation requires the gmail.compose scope which is included in the default (non-readonly) login.

If gws is not installed or authentication fails, tell the user to follow the setup instructions in the google-workspace skill.

Helper scripts are located in ${CLAUDE_SKILL_DIR} and require Python 3.10+.

---

Step 1: Identify the Meeting

Run the search once and save the result to a temp file:

EVENT_FILE=$(mktemp /tmp/meeting_event.XXXXXX)

# With a keyword (argument provided):
python3 "${CLAUDE_SKILL_DIR}/scripts/find_meeting.py" --days 7 "<keyword>" > "$EVENT_FILE"

# With keyword + specific date (recurring meeting):
python3 "${CLAUDE_SKILL_DIR}/scripts/find_meeting.py" --days 7 --date "<YYYY-MM-DD>" "<keyword>" > "$EVENT_FILE"

# No argument — list all recent events:
python3 "${CLAUDE_SKILL_DIR}/scripts/find_meeting.py" --days 7 > "$EVENT_FILE"

The script always outputs JSON. Read EVENT_FILE and display the result(s) to the user as a human-readable list.

The script searches the past 7 days (up to now). When a keyword matches multiple occurrences of a recurring meeting, it automatically picks the best one: the occurrence on --date if given, otherwise today's, otherwise the most recent past one.

Always confirm with the user before proceeding, regardless of how many results were found. Use AskUserQuestion:

"I found: on at . Is this the meeting you want to summarize? (yes / no — if no, describe the meeting you meant)"

If the user says no, ask for clarification and re-run find_meeting.py with a corrected keyword or --date, overwriting EVENT_FILE. If multiple events were returned, list them and ask the user to pick one by number, then re-run with --date to narrow to that occurrence.