Documentation
Everything you need to set up Google Calendar MCP and let your AI agent manage your calendar. Works with Claude Code, Cursor, Windsurf, Kiro, and any MCP-compatible client.
Tools
All tools available through the MCP server:
| Tool | Description |
|---|---|
| list_events | List upcoming calendar events within a time range |
| get_event | Get full details of a specific event |
| create_event | Create a new event with attendees, Meet link, recurrence |
| update_event | Update an existing calendar event |
| delete_event | Delete a calendar event |
| search_events | Search events by text query |
| quick_add_event | Create an event using natural language |
| respond_to_event | RSVP to an event (accept, tentative, decline) |
| get_free_busy | Check free/busy status for people |
| list_calendars | List all accessible calendars |
| move_event | Move an event to a different calendar |
| get_colors | Get available event color options |
| list_accounts | List connected Google accounts |
| switch_account | Switch active account |
| add_account | Connect another Google account |
| remove_account | Disconnect an account |
Compatibility
Supported accounts
| Account type | Status |
|---|---|
| Personal Google accounts (gmail.com) | Fully supported |
| Google Workspace accounts | Fully supported |
| Google Workspace with restricted API access | May require admin approval |
Google Workspace organizations
Works with Google Workspace accounts. Some organizations restrict third-party app access:
- If your org allows third-party apps: You can connect immediately.
- If your org restricts OAuth apps: Ask your admin to allowlist the app's OAuth client ID.
Permissions
The app requests these Google OAuth scopes (all delegated, meaning it can only access data on behalf of the signed-in user):
| Scope | Purpose |
|---|---|
| calendar | Full read/write access to calendars and events |
| calendar.events | Create, update, delete events |
| userinfo.email | Read your email address for account identification |
| userinfo.profile | Read your display name |
Security
- OAuth 2.0 Authorization Code flow (industry standard)
- Tokens encrypted at rest using AES-256-GCM
- Client secrets never stored on your machine (kept server-side only)
- API keys scoped per installation (one key per purchase)
- No data storage (calendar data passes through, never persisted on our servers)
Multi-account support
Connect unlimited Google accounts with a single purchase. Use the switch_account tool to change which account is active. All calendar tools operate on the currently selected account.