MCP Google Calendar

What is MCP Google Calendar?

MCP Google Calendar is a Model Context Protocol server that integrates Google Calendar with AI assistants like Claude, enabling calendar management through natural language conversations.

How to use MCP Google Calendar?

Install the package globally via npm, set up a Google Cloud project, enable the Calendar API, create OAuth credentials, and configure the required environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, MCP_PORT). Add the server configuration to Claude Desktop. On first run, authenticate through the browser-based OAuth flow.

Key features of MCP Google Calendar

• View upcoming events and meetings
• Create, update, and delete events
• Search events by time range, keywords, or participants
• Check free/busy times for scheduling
• List available calendars
• Set up meeting invitations with attendees

Use cases of MCP Google Calendar

• Schedule a meeting with a colleague at a specific time
• Check today’s events and find free time
• Cancel or reschedule existing meetings
• Search for events about a project or with a specific attendee
• Create recurring weekly meetings

FAQ from MCP Google Calendar

How do I set up the Google Calendar API?

Create a project in the Google Cloud Console, enable the Google Calendar API, generate OAuth 2.0 credentials (web application), and set the redirect URI to http://localhost:3000/oauth2callback.

How do I fix "Permission denied" errors?

Use the built-in launcher (node -e "require('child_process').spawn(...)") that does not rely on executable permissions, or manually fix permissions with chmod.

How do I clear the stored OAuth token?

Delete the token file at ~/.mcp-google-calendar/token.json and re-authenticate on the next run.

How do I run the server in debug mode?

Set the DEBUG environment variable to true when starting the server.

What Node.js version is required?

Node.js 16.x or higher is required.