Google Shared Calendar MCP
Allows managing Google Calendars shared with a service account, including listing accessible calendars, listing events in a time range, searching events, and creating, updating, and deleting events on configured calendars.
google-shared-calendar-mcp
An MCP server for Google Calendars shared with a service account.
The server can only reach calendars that are both shared with the service account and listed in its configuration. Nothing else on the calendar owner's account is visible to it, which makes it a good fit for agents that should manage a specific shared calendar (a household or team calendar, for example) without access to anyone's personal calendars.
Features
Service account authentication: no browser consent flow, no refresh tokens
Allowlist of calendar IDs, with a default calendar
List, create, update and delete events
Timezone handling based on each calendar's own setting
Optional "added by" line in event descriptions
Related MCP server: Google Calendar MCP Server
Setup
1. Create a service account
In the Google Cloud console, select or create a project.
Enable the Google Calendar API.
Create a service account under IAM & Admin > Service Accounts. It needs no IAM roles.
Create a JSON key for the service account and keep it outside version control.
2. Share the calendar
In Google Calendar, open the calendar's Settings and sharing.
Under Share with specific people or groups, add the service account's email (
client_emailin the JSON key).Choose Make changes to events.
Copy the Calendar ID under Integrate calendar.
Repeat for each calendar the server should manage.
Configuration
Variable | Required | Description |
| Yes | Path to the service account JSON key |
| Yes | Comma-separated calendar IDs. The first one is the default |
| No | IANA timezone (e.g. |
| No | Format of the "added by" line. Must contain |
Usage
Run with uv:
uvx --from git+https://github.com/gyeo-ri/google-shared-calendar-mcp@<tag> google-shared-calendar-mcpExample MCP client configuration (stdio):
{
"mcpServers": {
"google-shared-calendar": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/gyeo-ri/google-shared-calendar-mcp@<tag>",
"google-shared-calendar-mcp"
],
"env": {
"GOOGLE_SERVICE_ACCOUNT_KEY": "/path/to/service-account.json",
"GOOGLE_CALENDAR_IDS": "xxxx@group.calendar.google.com"
}
}
}
}Tools
Tool | Description |
| List the calendars the server can access |
| List events in a time range, with optional text search |
| Create an event |
| Update the given fields of an event |
| Delete an event |
All tools except list_calendars take an optional calendar_id. When omitted, the default calendar is used.
Time format
YYYY-MM-DD: all-day event. End dates are inclusive (2026-01-01to2026-01-02is a two-day event).YYYY-MM-DDTHH:MM:SS: interpreted in the calendar's timezone.YYYY-MM-DDTHH:MM:SS+09:00: used as given.
Limitations
Attendees cannot be invited. Google requires domain-wide delegation for service accounts to send invitations.
Recurring events are listed as individual instances. Creating or editing recurrence rules is not supported.
Development
uv sync
uv run pytestLicense
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent-Native Google Calendar - manage events, sync, and public booking
Schedule and manage Google Calendar events directly from your workspace. Check availability, view…
Permissioned access to Gmail, Drive and Calendar via the user's own Google account
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables management of multiple Google Calendar accounts with support for searching, creating, updating, and deleting events on primary calendars through natural language, with encrypted credential storage.9 npmMIT
- AlicenseBqualityDmaintenanceEnables interaction with Google Calendar services through the Model Context Protocol using a Service Account. It allows MCP-compatible clients to manage calendar events and integrate calendar data via the Google Calendar API.1ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to view, create, update, search, and manage Google Calendar events, including multi-account support and availability checks.14 npmBusiness Source 1.1
- AlicenseNot gradedqualityDmaintenanceEnables calendar management through Google Calendar API with OAuth2 authentication, multi-account support, and features like event creation, availability checking, and attendee management.MIT