Overview
What is Google Calendar MCP Server?
A Model Context Protocol (MCP) server that provides tools for interacting with the Google Calendar API. It enables developers to manage calendar events programmatically through the MCP interface.
How to use Google Calendar MCP Server?
Clone the repository, run npm install, create a credentials.json file with your OAuth 2.0 credentials, then execute node get-refresh-token.js to authenticate and obtain a token. After building with npm run build, add the server configuration to your MCP settings file (e.g., claude_desktop_config.json), specifying the GOOGLE_ACCESS_TOKEN environment variable.
Key features of Google Calendar MCP Server
- List upcoming events with date range filtering.
- Create new calendar events with attendees.
- Update existing calendar events.
- Delete calendar events.
Use cases of Google Calendar MCP Server
- List upcoming events within a specific date range.
- Schedule a team meeting with attendees via an AI assistant.
- Reschedule or modify event details programmatically.
- Remove obsolete calendar entries.
FAQ from Google Calendar MCP Server
What are the prerequisites?
You need Node.js 14 or higher and a Google Cloud Console project with the Calendar API enabled and OAuth 2.0 credentials configured.
How do I obtain an access token?
Run node get-refresh-token.js; it will open a browser for Google OAuth authentication, save the token to token.json, and display the refresh token in the console.
Where do I configure the MCP server?
In the MCP settings file for your client—for example, ~/Library/Application Support/Claude/claude_desktop_config.json for the Claude desktop app.
What permissions does the server request?
The server requests the https://www.googleapis.com/auth/calendar scope, granting full access to the user's calendar.
How do I specify the calendar time zone or use a different calendar?
The README does not mention time zone configuration or selecting a non-default calendar; only event properties like start and end (ISO 8601 format) are documented.
