calendar-reviewer

Extract today's meetings and calculate free time blocks from Google Calendar via MCP.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/jay-stacey/claude-plugins --skill calendar-reviewer-jay-stacey
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: calendar-reviewer
Source: https://github.com/jay-stacey/claude-plugins/tree/main/plugins/executive-assistant/skills/calendar-reviewer
Command: npx skills add https://github.com/jay-stacey/claude-plugins --skill calendar-reviewer-jay-stacey

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manually reviewing a calendar to find open slots and understand the day's schedule is tedious and error-prone. This Skill reads Google Calendar events through the Google Workspace MCP server, computes free time gaps within working hours, and labels them by energy pattern for day planning. ## Core Features & Use Cases - Schedule Extraction: Pulls today's meetings, all-day events, durations, locations, and attendees from Google Calendar using MCP tools like get_events and query_freebusy. - Free Time Analysis: Identifies gaps between meetings within configurable working hours, filters by minimum block duration, and tags each block with an energy pattern (Deep Work, Meetings/Collab, Focus Time). - Conflict Detection: Flags back-to-back meeting chains and overlapping double-booked events in a structured markdown report and JSON output. - Use Case: Before starting your workday, ask for a calendar review to see three meetings totaling 2.5 hours, five free blocks totaling 6.5 hours, and the best deep work slot from 8:00 to 9:00 AM. ## Quick Start Review my Google Calendar for today and show me my meetings, free time blocks, and any scheduling conflicts.

Frequently Asked Questions about calendar-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find free time blocks in my Google Calendar?▼

Use the get_events MCP tool to fetch today's events, sort them by start time, and compute gaps between meetings within your configured working hours. Gaps meeting the minimum block duration (default 30 minutes) are returned as free blocks with energy labels.

What MCP tools are needed to read Google Calendar events?▼

This Skill uses the Google Workspace MCP server tools: list_calendars to identify calendars, get_events with time_min and time_max for events in a date range, and query_freebusy for availability checks. All tools return structured data directly.

Can this Skill create or modify calendar events?▼

No. It operates strictly in read-only mode and never modifies, deletes, or responds to calendar events or invitations. Event creation is handled separately by a calendar-manager component with explicit user approval.

What happens if Google Calendar authentication fails?▼

The Skill reports that Google Calendar requires authentication, suggests checking the MCP server status with /mcp, verifies the Google Workspace MCP connection, and allows skipping the calendar review so the rest of the workflow continues.

How are back-to-back meetings and conflicts detected?▼

Events are sorted by start time to build a busy timeline. Meetings with no gap between them are flagged as back-to-back chains, and overlapping events are reported as conflicts. Conflicted time is never counted as free time.