Best for
- Users who want AI assistant integration with Google Calendar
- Users with multiple Google accounts
- Users needing advanced event management, such as recurring events and free/busy queries
G
Google Calendar MCP Server
Community
Google Calendar integration for AI assistants
GitHub source repository ↗
50FMRS · D
This server offers a comprehensive MCP integration for Google Calendar, with rich features like multi-account support and smart scheduling. It requires proper OAuth setup and may have a learning curve. Overall, it's a solid option for users who want to manage their calendars directly through an AI assistant.
This server implements the Model Context Protocol (MCP) for Google Calendar, offering multi-account, multi-calendar support and advanced event management. It allows AI assistants to perform operations like create, update, delete, and search events, handle recurring events, check free/busy status, and understand natural language dates and times. The server supports intelligent import of events from images, PDFs, and web links, and can detect conflicts across calendars. It requires a Google Cloud project and OAuth setup.
Tools
list-calendars
List all available calendars
list-events
List events with date filtering
get-event
Get details of a specific event by ID
search-events
Search events by text query
create-event
Create new calendar events
update-event
Update existing events
delete-event
Delete events
respond-to-event
Respond to event invitations (Accept, Decline, Maybe, No Response)
get-freebusy
Check availability across calendars, including external calendars
get-current-time
Get current date and time in calendar's timezone
list-colors
List available event colors
manage-accounts
Add, list, or remove connected Google accounts
Setup
- Create a project in Google Cloud Console and enable the Google Calendar API.
- Create OAuth 2.0 credentials, select 'Desktop app' type, and download the JSON key file.
- Add the server to Claude Desktop configuration using npx and provide the credentials path.
- Start Claude Desktop and ask the AI to authenticate with the Google Calendar MCP server.
- Complete the OAuth flow in your browser.
claude_desktop_config.json
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["@cocal/google-calendar-mcp"],
"env": {
"GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
}
}
}
}
Fit and risk
Not for
- Users without a Google Cloud project
- Users who want a quick setup without OAuth configuration
- Users who need integration with calendar systems other than Google Calendar
Required permissions
- Read and modify Google Calendar events
- Access calendars across accounts
- Create, update, delete, and search events
- Respond to invitations
- Check free/busy information
Risks and side effects
- OAuth tokens can be exposed or expired
- In test mode, tokens expire after 7 days and need re-authentication
- Users should be aware of Google Cloud quotas and limits
- Credentials may be exposed in logs if misconfigured
Troubleshooting
- Ensure GOOGLE_OAUTH_CREDENTIALS points to a valid credentials file
- Verify credentials are for 'Desktop app' and test user is added
- Re-authenticate by running npm run auth or npx @cocal/google-calendar-mcp auth
- Check that ports 3500-3505 are not blocked, as they are used for authentication
- Ensure credentials file includes project_id to avoid rate limit errors
Use cases
Finding availability across personal and work calendars
Adding events from screenshots or images
Analyzing calendar for unusual events
Checking attendance and responding to invitations
Automatically coordinating events based on provided availability
Supported clients
Claude DesktopFull support