Provides tools for managing Google Calendar events, calendars, sharing permissions, and scheduling with full read/write access across multiple Google accounts.
Allows creating events with Google Meet video conferencing, enabling seamless scheduling of online meetings.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-google-gcal list my events for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for Google Calendar. Lets AI assistants manage events, calendars, sharing, and scheduling with full read/write access across multiple Google accounts. Supports natural language event creation, recurring events, Google Meet conferencing, free/busy queries, and ACL management.
Tool | Description |
| List events with time range, search, pagination, and event type filtering |
| Get full event details by ID |
| Create event with attendees, recurrence, Google Meet, attachments, and more |
| Update event fields using patch semantics |
| Delete event with notification control |
| Create event from natural language text |
| Move an event from one calendar to another |
| List individual occurrences of a recurring event |
| Import event from external system preserving iCalUID |
Tool | Description |
| List all calendars on the user's calendar list |
| Get calendar metadata (summary, description, timezone) |
| Create a new secondary calendar |
| Edit calendar metadata using patch semantics |
| Delete a secondary calendar |
| Clear all events from the primary calendar (irreversible) |
Tool | Description |
| Get a calendar's list-level settings (color, reminders, notifications) |
| Add an existing calendar to the user's calendar list |
| Update color, reminders, or notification preferences |
| Remove a calendar from the user's list (does not delete it) |
Tool | Description |
| List sharing permissions on a calendar |
| Share a calendar with a user, group, or domain |
| Change the sharing role for an existing rule |
| Revoke a sharing rule |
Tool | Description |
| List user calendar settings (timezone, locale, format preferences) |
| Get color definitions for calendars and events |
| Query free/busy information for calendars and groups |
Related MCP server: google-calendar-mcp
All read and list tools support an outputFormat parameter:
Format | Description | Use Case |
| Pretty-printed JSON (default) | Machine consumption, API pipelines |
| YAML serialization | Human-readable structured data |
| Compact aligned tables and key-value pairs | Quick scanning, token-efficient LLM context |
Node.js 18+
A Google Cloud project with the Google Calendar API enabled
OAuth2 desktop application credentials
Create or use an existing project in the Google Cloud Console and enable the Google Calendar API
Create OAuth2 credentials (Application type: Desktop app) and download the JSON file
Save the credentials file:
mkdir -p ~/.config/mcp-google-gcal
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gcal/credentials.jsonRun the one-time authorization flow:
npx mcp-google-gcal --auth primaryThis prints a URL for Google consent. After granting access, paste the authorization code back into the terminal.
Add additional accounts with unique labels:
npx mcp-google-gcal --auth work
npx mcp-google-gcal --auth personalPass the account parameter to any tool to specify which account to use.
claude mcp add -s user google-gcal -- npx -y mcp-google-gcal{
"mcpServers": {
"google-gcal": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-google-gcal"]
}
}
}{
"mcpServers": {
"google-gcal": {
"command": "npx",
"args": ["-y", "mcp-google-gcal"]
}
}
}MIT
This server cannot be deployed
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
GDPR-compliant calendar access for AI assistants: read, create, edit, RSVP. Google, MS 365, Apple.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
