google-calendar

The Google Calendar plugin provides a powerful interface for Claude Code to manage complex, multi-account schedules. Designed for professionals balancing personal and work life, this tool allows for seamless aggregation of events from multiple Google Calendar sources. By leveraging subagent parallel execution, it delivers fast, consolidated views of your week or day, highlighting potential scheduling overlaps and conflicts before they become issues. Whether you need to schedule a new team meeting, adjust an existing appointment, or simply get a quick summary of your upcoming commitments, this plugin automates the interaction with Google's Calendar API.

• Multi-account integration: Sync work and personal calendars into a single, unified view.

• Parallel query engine: Uses subagents to fetch event data from multiple accounts simultaneously for maximum speed.

• Intelligent conflict detection: Automatically identifies overlapping events across different accounts and provides visual alerts.

• Full CRUD operations: Create, read, update, and delete calendar events via natural language commands.

• Secure authentication: Utilizes Google OAuth 2.0 with persistent refresh token storage to eliminate the need for repeated logins.

• Usage Note: Initial setup requires a Google Cloud Project with the Calendar API enabled and an OAuth 2.0 Client ID (Desktop type).

• Workflow: Use the provided setup_auth.py script once per account to authenticate; thereafter, Claude manages the sync automatically.

• Inputs/Outputs: Accepts natural language prompts like "Show my schedule for today" or "Create a team meeting tomorrow at 3 PM" and outputs a structured markdown format with color-coded account indicators.

• Constraints: Accounts are managed locally via JSON token files stored securely. Users should ensure sensitive credentials are not committed to version control systems.

• Keywords: Google Calendar, GCal, Scheduling, Conflict detection, Multi-account management, OAuth2, Productivity, Time management, API automation.