Google Calendar MCP

Overview

The Google Calendar MCP server enables AI agents to interact with Google Calendar, allowing them to read events, check availability, create and modify appointments, and manage schedules. This is essential for building AI assistants that can help with meeting scheduling, time management, and calendar organization.

Features

• Read Events: Query calendar events by date range, search, or specific calendar
• Check Availability: Find free time slots for scheduling
• Create Events: Schedule new meetings and appointments
• Update Events: Modify existing events (time, title, attendees)
• Delete Events: Remove events from calendar
• Multiple Calendars: Support for primary and shared calendars
• Time Zone Awareness: Handle time zones correctly

Installation

npx -y @modelcontextprotocol/server-google-calendar

Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-calendar"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

OAuth Setup

1. Go to Google Cloud Console
2. Create a new project
3. Enable the Google Calendar API
4. Create OAuth 2.0 credentials
5. Download the credentials JSON file
6. Set the GOOGLE_APPLICATION_CREDENTIALS environment variable

Available Tools

Tool	Description
list_calendars	List all accessible calendars
list_events	List events within a date range
search_events	Search for events by keyword
get_event	Get details of a specific event
create_event	Create a new calendar event
update_event	Update an existing event
delete_event	Delete an event
find_free_time	Find available time slots

Usage Examples

List Today's Events

List all events for today on my primary calendar.

Check Availability

Find a 30-minute slot next Tuesday afternoon when I'm free.

Create a Meeting

Schedule a team meeting for next Friday at 2pm for 1 hour with Alice and Bob.

Search Events

Find all events with "project review" in the title this month.

Claude Desktop Setup

1. Install the MCP server
2. Configure OAuth credentials
3. Add to claude_desktop_config.json
4. Restart Claude Desktop

Pros

• ✅ Native Google Calendar integration
• ✅ Full CRUD operations
• ✅ Availability checking
• ✅ Multi-calendar support
• ✅ Time zone handling

Cons

• ❌ Requires OAuth setup (more complex than API keys)
• ❌ Limited to Google Calendar ecosystem
• ❌ Rate limits apply

Resources

• MCP Server Repository
• Google Calendar API Docs
• OAuth Setup Guide