Google Calendar MCP Server

About

## Google Calendar MCP Server: Calendar Management The **Google Calendar MCP Server** integrates Google Calendar into Google Antigravity, enabling developers to create, manage, and query calendar events through AI-assisted scheduling workflows. ### Why Google Calendar MCP? - **Native Integration**: Direct access to Google Calendar API - **Multi-Calendar**: Manage multiple calendars and shared calendars - **Event Types**: Support for meetings, reminders, and all-day events - **Recurrence**: Create and manage recurring events - **Availability**: Check free/busy status for scheduling ### Key Features #### 1. Event Management ```javascript // Create event const event = await gcal.createEvent({ calendarId: "primary", summary: "Sprint Planning", description: "Bi-weekly sprint planning meeting", start: { dateTime: "2024-12-16T10:00:00", timeZone: "America/New_York" }, end: { dateTime: "2024-12-16T11:00:00", timeZone: "America/New_York" }, attendees: [ { email: "team@company.com" } ], conferenceData: { createRequest: { requestId: "meet-" + Date.now() } }, recurrence: ["RRULE:FREQ=WEEKLY;INTERVAL=2;BYDAY=MO"] }); // List upcoming events const events = await gcal.listEvents({ calendarId: "primary", timeMin: new Date().toISOString(), timeMax: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(), singleEvents: true, orderBy: "startTime" }); ``` #### 2. Availability and Calendars ```javascript // Check free/busy const availability = await gcal.getFreeBusy({ timeMin: "2024-12-16T00:00:00Z", timeMax: "2024-12-20T23:59:59Z", items: [ { id: "user1@company.com" }, { id: "user2@company.com" } ] }); // List calendars const calendars = await gcal.listCalendars(); // Create calendar const newCalendar = await gcal.createCalendar({ summary: "Project Alpha", description: "Calendar for Project Alpha milestones" }); ``` ### Configuration ```json { "mcpServers": { "google-calendar": { "command": "npx", "args": ["-y", "@anthropic/mcp-gcal"], "env": { "GOOGLE_CREDENTIALS": "/path/to/credentials.json", "GOOGLE_TOKEN": "/path/to/token.json" } } } } ``` ### Use Cases **Meeting Scheduling**: Create and manage team meetings with video conferencing. **Project Milestones**: Track project deadlines and milestones on shared calendars. **Availability Checks**: Find optimal meeting times based on team availability. The Google Calendar MCP Server brings powerful calendar management to your workflow.

Installation

{
  "mcpServers": {
    "google-calendar": {
      "mcpServers": {
        "google-calendar": {
          "env": {
            "GOOGLE_OAUTH_CREDENTIALS": "/path/to/gcp-oauth.keys.json"
          },
          "args": [
            "-y",
            "@cocal/google-calendar-mcp"
          ],
          "command": "npx"
        }
      }
    }
  }
}

How to Use

1. 11. Create OAuth credentials in Google Cloud Console
2. 22. Download credentials and set path in GOOGLE_OAUTH_CREDENTIALS
3. 33. Supports multiple accounts and calendars