gcalendar-mcp
Manages Google Calendar reminders with support for time-based and location-based triggers, including creating, listing, and deleting reminders.
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., "@gcalendar-mcp remind me tomorrow at 9am to call mom"
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.
Google Calendar MCP Server
An MCP (Model Context Protocol) server for managing Google Calendar reminders with support for time-based and location-based triggers.
Features
Time-based reminders: "Remind me tomorrow at 9am to call mom"
Location-based reminders: "Remind me to go to store X when I'm near Hashalom street in Tel Aviv"
List reminders: View upcoming reminders
Delete reminders: Remove reminders by ID
Related MCP server: GoogleCalendarMCP
Prerequisites
Python 3.11+
uv package manager
Google Cloud project with Calendar API enabled
Setup
1. Install dependencies
uv sync2. Set up Google Cloud credentials
Go to Google Cloud Console
Create a new project or select an existing one
Enable the Google Calendar API:
Go to "APIs & Services" > "Library"
Search for "Google Calendar API"
Click "Enable"
Create OAuth 2.0 credentials:
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "OAuth client ID"
Choose "Desktop app" as the application type
Download the credentials JSON file
Save the credentials file:
mkdir -p ~/.config/gcalendar-mcp mv ~/Downloads/client_secret_*.json ~/.config/gcalendar-mcp/credentials.json
3. First-time authentication
Run the server once to authenticate:
uv run gcalendar-mcpThis will open a browser window for Google OAuth. After authorizing, your credentials will be saved.
Usage with Claude Code
Add to your Claude Code MCP configuration (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"gcalendar": {
"command": "uv",
"args": ["run", "--directory", "/path/to/gcalendar_mcp", "gcalendar-mcp"]
}
}
}Available Tools
create_time_reminder
Create a time-based reminder.
Parameters:
title(required): What to be reminded abouttime(required): When to remind (natural language supported)description(optional): Additional notes
Examples:
"remind me tomorrow at 9 to call mom"
"remind me in 2 hours to take a break"
"remind me today at 3pm to join the meeting"
create_location_reminder
Create a location-based reminder.
Parameters:
title(required): What to be reminded aboutlocation(required): The location/addressdescription(optional): Additional notesdate(optional): Date for the reminder
Examples:
"remind me to buy milk when near the grocery store"
"remind me to go to store X when I'm near Hashalom street in Tel Aviv"
Note: Google Calendar doesn't natively support location-based triggers. This creates an event with the location noted. For automatic location notifications, use Google Maps or a dedicated location reminder app.
list_reminders
List upcoming reminders from the calendar.
Parameters:
max_results(optional): Maximum number of results (default: 10)
delete_reminder
Delete a reminder by its event ID.
Parameters:
event_id(required): The ID of the event to delete
Configuration
You can customize the credentials directory by setting the environment variable:
export GCALENDAR_MCP_CONFIG_DIR=/path/to/custom/configDevelopment
# Install dev dependencies
uv sync --dev
# Run tests
uv run pytestLicense
MIT
Available Tools
4 toolscreate_location_reminderA
Create a location-based reminder in Google Calendar. Examples: 'remind me to buy milk when near the grocery store', 'remind me to go to store X when I'm near Hashalom street in Tel Aviv'
Inputs: title (required), location (required), date, description.
create_time_reminderA
Create a time-based reminder in Google Calendar. Examples: 'remind me tomorrow at 9 to call mom', 'remind me in 2 hours to take a break'
Inputs: time (required), title (required), description.
delete_reminderB
Delete a reminder from Google Calendar by its event ID
Inputs: event_id (required).
list_remindersB
List upcoming reminders and events from Google Calendar
Inputs: max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: creating location-based reminders, creating time-based reminders, deleting reminders, and listing reminders. There is no overlap or ambiguity.
All tools follow a consistent verb_noun pattern with lowercase snake_case (create_location_reminder, create_time_reminder, delete_reminder, list_reminders). No deviations.
With 4 tools covering creation (two types), deletion, and listing, the set is well-scoped for a reminder management server. Each tool adds clear value.
Core operations are present, but an update tool for modifying reminders is missing, which agents may need. This is a minor gap given the scope.
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.
The Google Compute Engine MCP server is a fully-managed Model Context Protocol server that provides tools to manage Google Compute Engine resources through AI agents. It enables capabilities including instance management (creating, starting, stopping, resetting, listing), disk management, handling instance templates and group managers, viewing machine and accelerator types, managing images, and accessing reservation and commitment information. The server operates as a zero-deployment, enterprise-grade endpoint at https://compute.googleapis.com/mcp with built-in IAM-based security.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
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
- AlicenseNot gradedqualityDmaintenanceA Google Calendar MCP server that enables listing, creating, updating, and deleting calendar events and calendars through natural language.8 npmISC
- FlicenseNot gradedqualityDmaintenanceA minimal MCP server for Google Calendar using OAuth 2.0, enabling calendar management, event CRUD, sharing, and push notifications via natural language.-