google-calendar

The Google Calendar plugin for Claude Code provides a powerful, unified interface for managing multiple Google accounts simultaneously. Designed for power users, professionals, and anyone balancing work and personal schedules, this tool bridges the gap between AI-driven task management and calendar planning. It eliminates the need to manually toggle between browser tabs or accounts by centralizing all your scheduling data into a single, cohesive command-line workflow.

• Multi-Account Aggregation: Seamlessly fetch and display events from multiple Google accounts (e.g., work, personal) in one view.

• Intelligent Conflict Detection: Automatically identify overlapping events across different accounts, providing visual warnings for double-booked time slots.

• Parallel Execution: Leverages subagent orchestration to query multiple calendars simultaneously, ensuring rapid response times even with several accounts connected.

• Full CRUD Operations: Execute complex scheduling tasks such as creating, updating, or deleting calendar events directly through natural language prompts.

• Secure Authentication: Utilizes persistent refresh tokens via OAuth 2.0, meaning you only need to perform the initial setup once per account without repetitive manual logins.

• Prerequisites: Requires a Google Cloud Project with the Calendar API enabled and an OAuth 2.0 Client ID (Desktop type).

• Usage Notes: Initial authentication is performed via the provided setup_auth.py script, which safely stores refresh tokens. Security best practices are strictly enforced; tokens and client secrets must be excluded from version control via .gitignore.

• Input/Output: Accepts natural language commands like 'What does my week look like?' or 'Add a team meeting tomorrow at 3pm.' Results are presented in a clean, time-sorted format highlighting total events and any detected conflicts.

• Constraints: Standard Google Calendar API quotas apply. The plugin is designed for local execution via Claude Code using the uv package manager and Python runtime.

• Keywords: Google Calendar, scheduling, calendar integration, multi-account, OAuth2, conflict detection, time management, automation, CLI productivity, event management.