google-calendar-daily-brief

Google Calendar Daily Brief

Overview

Use this skill to turn one day of Google Calendar events into a readable daily brief instead of a raw event dump. Use the Google Calendar app from this plugin for the source data, then use the bundled formatter as the default rendering path.

Workflow

1. Resolve the date window explicitly in the user's timezone.
2. Fetch the day's events through the Google Calendar app/connector for the relevant calendar. Default to calendar_id=primary unless the user names a different calendar.
3. Pass the raw JSON response to scripts/render_day_brief.py.
4. Return the rendered Markdown as the answer. Lightly adapt the lead-in or emphasis if the user asked for a narrower scope, a more compact answer, or a specific focus.

Relevant Actions

• Prefer search_events for the one-day event list that feeds the formatter.
• Use search_events_all_fields only if the brief needs richer event metadata than the standard event summary surface returns.

Data Source Rules

• Use the Google Calendar app/connector from this plugin, not web search and not a manually reconstructed schedule.
• Query with explicit day boundaries such as [local_midnight, next_local_midnight) in the user's timezone.
• Prefer the app's event search/list call that accepts calendar_id, time_min, time_max, and timezone.
• Preserve titles exactly as returned by Google Calendar.

Default Shape

The formatter's default shape is a good baseline:

• date header
• short top summary lines
• Day Shape
• Agenda
• optional What Needs Attention
• Useful Readout
• optional Remaining Today

Keep the tone compact and practical. Do not use a fenced code block for the agenda.

Formatter

Run the formatter whenever you want the full daily brief:

python3 scripts/render_day_brief.py \
  --time-min 2026-03-11T00:00:00-07:00 \
  --time-max 2026-03-12T00:00:00-07:00 \
  --timezone America/Los_Angeles \
  --now 2026-03-11T17:02:19-07:00

Provide the Google Calendar JSON payload on stdin. The script accepts either: