gcal-fast-mcp
Provides tools for calendar management, event CRUD (create, read, update, delete), and availability checking via the Google Calendar API.
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., "@gcal-fast-mcp what are my events for tomorrow?"
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-fast-mcp
Google Calendar MCP server built with FastMCP. Provides 10 tools for calendar management, event CRUD, and availability queries via the Google Calendar API v3.
Setup
1. Google OAuth Credentials
Place your Google Cloud OAuth client credentials at ~/.gcal-mcp/gcp-oauth.keys.json (or in the project directory — they'll be copied automatically).
If you already have a GCP project configured for another Google API (e.g. gmail-fast-mcp), you can reuse the same OAuth client — just enable the Google Calendar API in that project.
2. Authenticate
uv run python -m gcal_fast_mcp authThis opens a browser for the OAuth flow and saves tokens to ~/.gcal-mcp/credentials.json.
For cloud environments with a custom callback URL:
uv run python -m gcal_fast_mcp auth https://your-domain.com/oauth2callback3. Run the Server
uv run python -m gcal_fast_mcpMCP Client Configuration
{
"mcpServers": {
"google-calendar": {
"command": "uv",
"args": ["--directory", "/path/to/gcal-fast-mcp", "run", "google-calendar-fast-mcp"]
}
}
}Related MCP server: GoogleCalendarMCP
Tools
Tool | Description |
| List all calendars the user has access to |
| Get details of a specific calendar |
| List events within a time range (supports search, recurring expansion) |
| Get full details of a single event |
| Create a new event with attendees, location, etc. |
| Update an existing event (partial updates supported) |
| Delete an event |
| Create an event from natural language (e.g. "Lunch tomorrow at noon") |
| Check free/busy status for one or more calendars |
Configuration
Environment variables (prefix GCAL_):
Variable | Default | Description |
|
| OAuth client secrets file |
|
| Saved OAuth tokens |
|
| Default calendar ID |
|
| Default max events returned |
Google Calendar API Scopes
calendar— Full calendar accesscalendar.events— Event CRUD operations
Available Tools
9 toolscheck_availabilityARead-onlyIdempotent
Check free/busy status for one or more calendars. Returns busy time ranges per calendar.
Inputs: time_max (required), time_min (required), calendars. Returns: Generic wrapper for non-object return types.
create_eventC
Create a new calendar event.
Inputs: end (required), start (required), summary (required), location, +3 more. Returns: Generic wrapper for non-object return types.
delete_eventCDestructiveIdempotent
Delete a calendar event.
Inputs: event_id (required), calendar_id. Returns: Generic wrapper for non-object return types.
get_calendarARead-onlyIdempotent
Get details of a specific calendar.
Inputs: calendar_id. Returns: Generic wrapper for non-object return types.
get_eventBRead-onlyIdempotent
Get full details of a single calendar event.
Inputs: event_id (required), calendar_id. Returns: Generic wrapper for non-object return types.
list_calendarsARead-onlyIdempotent
List all calendars the user has access to. Returns JSON array.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
list_eventsARead-onlyIdempotent
List calendar events within a time range. Returns JSON array of events.
Inputs: query, order_by, time_max, time_min, +3 more. Returns: Generic wrapper for non-object return types.
quick_addA
Create an event from a natural language string using Google's NLP parser.
Inputs: text (required), calendar_id. Returns: Generic wrapper for non-object return types.
update_eventB
Update an existing calendar event. Only provided fields are changed.
Inputs: event_id (required), end, start, summary, +4 more. 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 9 tools
Each tool targets a distinct resource+action combination: calendars vs events are clearly separated, and get/list/create/update/delete are unambiguous. quick_add and check_availability are additional distinct operations. Only slight potential confusion exists between list_events and check_availability, though they serve different purposes (event detail vs busy windows).
All tools follow a consistent verb_noun pattern: list_calendars, get_calendar, list_events, get_event, create_event, update_event, delete_event. quick_add and check_availability deviate slightly but are well-established domain terms that read naturally and don't break the overall pattern.
Nine tools is well within the ideal 3-15 range. Each tool serves a meaningful purpose for a Google Calendar MCP server: full CRUD on calendars and events, plus two useful extras (NLP quick add and availability checking). No tool feels redundant or padding.
The surface provides full lifecycle coverage for both calendars (list, get) and events (list, get, create, update, delete). quick_add and check_availability round out common user workflows. Missing operations like moving events or managing reminders are minor and not core to basic calendar operations.
Maintenance
Related MCP Connectors
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides integration with Google Calendar, allowing users to list calendars and manage events. It enables searching, creating, and modifying calendar entries through tools designed for the Model Context Protocol.-
- AlicenseDqualityDmaintenanceMCP server for interacting with Google Calendar, enabling reading events from public calendars and, with OAuth, creating, updating, and deleting events.1ISC
- AlicenseAqualityBmaintenanceA sample MCP server built with FastMCP that demonstrates basic tools and a Google OAuth integration for accessing Google APIs like Calendar.2MIT
- AlicenseNot gradedqualityDmaintenanceA Google Calendar MCP server that enables listing, creating, updating, and deleting calendar events and calendars through natural language.8 npmISC