Google Calendar MCP
Check schedules, book meetings with Meet links and block focus time in Google Calendar
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 1.1.2
- Listing updated
- today
Similar MCP servers
About Google Calendar MCP
Google Calendar MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
This server lets an AI app manage Google Calendar through the official API with your own account. The README lists 19 tools: inspecting calendars, events and free/busy, creating and editing events, expanding recurring series, blocking Out of Office and Focus Time, and six for connecting your Google account from the chat so no credentials file has to be hand-written.
It is cautious about side effects. The Calendar API's default is not to email guests, and this server sends invitations, changes or cancellations only when you ask through the send_updates option. After an ambiguous failure it does not retry a write, because a duplicate event could email every guest again. It also separates a whole recurring series from a single occurrence, so you can cancel one Friday standup without touching the rest.
Scopes are kept narrow, using calendar.events and calendar.readonly rather than the broad calendar scope. It runs over stdio with Node.js 20 or later and OAuth credentials from a Google Cloud project with the Calendar API enabled.
Install
Run in a terminal
claude mcp add mcp-google-calendar --env GOOGLE_CALENDAR_CLIENT_SECRET='<GOOGLE_CALENDAR_CLIENT_SECRET>' --env GOOGLE_CALENDAR_REFRESH_TOKEN='<GOOGLE_CALENDAR_REFRESH_TOKEN>' --env GOOGLE_CALENDAR_ACCESS_TOKEN='<GOOGLE_CALENDAR_ACCESS_TOKEN>' -- npx -y @a1-x-tech/mcp-google-calendarAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-google-calendar": {
"command": "npx",
"args": [
"-y",
"@a1-x-tech/mcp-google-calendar"
],
"env": {
"GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
"GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
"GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-google-calendar": {
"command": "npx",
"args": [
"-y",
"@a1-x-tech/mcp-google-calendar"
],
"env": {
"GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
"GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
"GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-google-calendar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@a1-x-tech/mcp-google-calendar"
],
"env": {
"GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
"GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
"GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-google-calendar": {
"command": "npx",
"args": [
"-y",
"@a1-x-tech/mcp-google-calendar"
],
"env": {
"GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
"GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
"GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-google-calendar": {
"command": "npx",
"args": [
"-y",
"@a1-x-tech/mcp-google-calendar"
],
"env": {
"GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
"GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
"GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GOOGLE_CALENDAR_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).GOOGLE_CALENDAR_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.GOOGLE_CALENDAR_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.GOOGLE_CALENDAR_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.GOOGLE_CALENDAR_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.GOOGLE_CALENDAR_API_BASEAPI root override.GOOGLE_CALENDAR_TIMEOUT_MSPer-request timeout in milliseconds.GOOGLE_CALENDAR_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).
What it does
- Schedule review
- Lists events and spots overlapping meetings.
- Meeting creation
- Schedules events with guests and a Google Meet link.
- Free slot finding
- Uses free/busy to find a time several people share.
- Recurring series control
- Edits or cancels one occurrence or the whole series.
- Out of Office and Focus Time
- Blocks time and can auto-decline invitations.
- Quiet by default
- Guests are emailed only when send_updates is requested.
Good for
- Review the week and find overlapping meetings
- Book a 45-minute review with guests and a Meet link
- Find an hour when three people are free
- Cancel a single occurrence of a recurring meeting
- Block focus time tomorrow morning
Pricing
Open source
Open-source npm package; Google API quotas apply
Google Calendar MCP FAQ
Will guests get emails automatically?
No. The README says guests get email only when you ask via send_updates.
What happens after a failed write?
The server does not replay writes after an ambiguous failure, to avoid duplicate events.
Which Google scopes does it use?
calendar.events and calendar.readonly, not the broad calendar scope.
Can I sign in from the chat?
Yes, six of the tools handle connecting your Google account without a credentials file.
What does it need?
Node.js 20 or later and OAuth credentials with the Calendar API enabled.
Is Google Calendar MCP free?
Yes. Google Calendar MCP is open source, so you can use and self-host it for free.
How do I add Google Calendar MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp-google-calendar --env GOOGLE_CALENDAR_CLIENT_SECRET='<GOOGLE_CALENDAR_CLIENT_SECRET>' --env GOOGLE_CALENDAR_REFRESH_TOKEN='<GOOGLE_CALENDAR_REFRESH_TOKEN>' --env GOOGLE_CALENDAR_ACCESS_TOKEN='<GOOGLE_CALENDAR_ACCESS_TOKEN>' -- npx -y @a1-x-tech/mcp-google-calendar
What are the best alternatives to Google Calendar MCP?
The closest alternatives to Google Calendar MCP are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
