Google Calendar MCP Server
Provides tools to query Google Calendar events, including functionality to list calendars, search for events by keyword, and retrieve upcoming or date-specific events.
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., "@Google Calendar MCP Server What's on my calendar 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.
gcal-mcp
A Model Context Protocol (MCP) server for Google Calendar that uses OAuth 2.0 with PKCE for secure authentication.
Bring your own Oauth client
To use your own OAuth client credentials:
gcal-mcp --credentials /path/to/credentials.jsonAvailable Tools
3 toolsget_events_for_dateA
Get calendar events for a specific date.
Args: date: Date in YYYY-MM-DD format calendar_id: Calendar ID to query (default: "primary")
Returns: Formatted list of events for that date
Inputs: date (required), calendar_id. Returns: Generic wrapper for non-object return types.
get_upcoming_eventsA
Get upcoming calendar events.
Args: max_results: Maximum number of events to return (default: 10) calendar_id: Calendar ID to query (default: "primary")
Returns: Formatted list of upcoming events with start time and title
Inputs: max_results, calendar_id. Returns: Generic wrapper for non-object return types.
search_eventsA
Search calendar events by keyword.
Args: query: Search term to find in event titles/descriptions max_results: Maximum number of events to return (default: 10) calendar_id: Calendar ID to query (default: "primary")
Returns: Matching events with start time and title
Inputs: query (required), max_results, calendar_id. Returns: Generic wrapper for non-object return types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: retrieving events for a specific date, listing upcoming events, and searching by keyword. Some overlap exists (e.g., upcoming events could be retrieved by date), but the descriptions differentiate them well.
All tool names follow a consistent verb_noun pattern with snake_case: get_events_for_date, get_upcoming_events, search_events. The pattern is predictable and easy to understand.
With only 3 tools, the server feels under-scoped for a calendar service. Most calendar servers provide create, update, delete, and calendar management operations, which are missing here.
The server only covers read/query operations (get, list, search). It lacks any write operations (create, update, delete events) or calendar management, leaving significant gaps for common workflows.
Maintenance
Related MCP Connectors
Schedule and manage Google Calendar events directly from your workspace. Check availability, view…
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Extracts calendar events from natural-language text, with .ics and calendar links.
Manage Google, Outlook & Apple calendars and create private sync rules from chat.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAllows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.2-
- AlicenseNot gradedqualityFmaintenanceIntegrates Google Calendar with AI assistants through the Model Context Protocol, allowing users to view and manage calendar events through natural language interaction.134 npm12MIT
- AlicenseAqualityDmaintenanceProvides comprehensive Google Calendar integration capabilities allowing AI assistants to list, create, update, and delete calendar events through a standardized Model Context Protocol.518 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language interaction with Google Calendar via the Model Context Protocol, allowing LLMs like Claude to read and manage calendar events through the Google Calendar v3 API.2-