Smart GWS Workflow Meeting Prep

Automatically prepare for your next meeting by pulling agenda details, attendee list, and linked documents from Google Calendar into a single, actionable briefing.

When to Use This Command

Run this command when you need a quick briefing for your upcoming meeting with all relevant context in one place.

• You want to review the agenda, attendees, and description for your next calendar event
• You need to identify linked Google Docs or Drive files mentioned in the meeting invite
• You are preparing talking points and want to see who will be in the room
• You need a quick overview before jumping into a meeting

Use it also when:

• You manage multiple calendars and need prep for events on a specific calendar
• You want to output meeting details in different formats for sharing with your team

Quick Start

Copy
# .claude/commands/smart-gws-workflow-meeting.md
name: smart-gws-workflow-meeting
description: Prepare for your next meeting with full context
arguments:
  calendar: Calendar ID (optional, defaults to primary)

Copy
# Prepare for the next meeting on your primary calendar
claude smart-gws-workflow-meeting

Expected output:
Next Meeting:
  Title: Sprint Review
  Time: 11:00 AM - 12:00 PM (March 15, 2026)
  Location: Conference Room B / meet.google.com/abc-def-ghi

Attendees:
  - [email protected] (organizer)
  - [email protected] (accepted)
  - [email protected] (tentative)

Description:
  Review sprint velocity and demo completed features.

Linked Documents:
  - Sprint Board: https://docs.google.com/spreadsheets/d/...
  - Demo Script: https://docs.google.com/document/d/...

Core Concepts

Concept	Description
Next Event	The chronologically next calendar event from the current time
Attendees	Participants with their response status (accepted, tentative, declined)
Description	The meeting invite body, often containing agenda and context
Linked Docs	Google Drive URLs detected in the event description or attachments
Calendar ID	Identifier for the calendar to query (default: primary)

Meeting Prep Pipeline:
  Calendar API ──> Get Next Event ──> Parse Details
                                          │
                         ┌────────────────┼────────────┐
                         v                v            v
                    Attendees        Description    Linked Docs
                    + Status         + Agenda       + URLs

Configuration

Parameter	Default	Description
calendar	primary	Calendar ID to query for the next event
format	json	Output format: json, table, yaml, csv
dry-run	false	Preview the query without executing
params	none	Additional calendar query parameters
page-all	false	Retrieve multiple upcoming events

Best Practices

1. Run this 5-10 minutes before each meeting -- Give yourself enough time to review attendees, read linked documents, and prepare talking points.

2. Use table format for quick scanning -- The table output provides a compact, readable summary perfect for a pre-meeting glance.

3. Check attendee response status -- Pay attention to who has declined or not responded. This helps set expectations for meeting attendance.

4. Open linked documents in advance -- The extracted document URLs let you pre-load relevant files so you are not scrambling during the meeting.

5. This command is read-only -- Meeting prep never modifies any data. It only reads from Calendar, so it is safe to run at any time without confirmation.

Common Issues

1. No upcoming event found -- If your calendar has no future events for today, the command returns empty. Check that events exist on the queried calendar.

2. Wrong calendar selected -- Multi-calendar users may get results from the wrong calendar. Specify the calendar ID explicitly with --calendar.

3. Linked documents not detected -- Documents must be referenced as URLs in the event description or as event attachments. Files added through the Calendar UI attachment feature may use a different format than inline URLs.