Which integrations are available for this server?

Provides programmatic access to Google services for managing calendars and scheduling events. Enables tools for listing calendars, searching or listing events within time ranges, creating new events with location and attendee details, and patching existing calendar entries. Utilizes Google Cloud for OAuth 2.0 authentication and API management to secure access to calendar data and services.

How do I use gcal-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gcal-mcp What's on my calendar for the rest of 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

MCP server for Google Calendar. Provides four tools: list calendars, list/search events, create events, and modify events.

Prerequisites

uv
A Google Cloud project with the Calendar API enabled

Google Cloud Setup

Go to Google Cloud Console
Create a project (or select an existing one)
Enable the Google Calendar API
Go to APIs & Services > Credentials
Create an OAuth 2.0 Client ID of type Desktop App
Download the credentials JSON and save it to ~/.config/gcal-mcp/credentials.json
Go to OAuth consent screen and add your Google account as a test user

Install & Authenticate

make install # install dependencies make auth # opens browser for OAuth consent, prints calendars on success

Register with Claude Code

make register # adds gcal-mcp as a user-scoped MCP server make unregister # removes it

Tools

Tool	Description
`list_calendars`	List all accessible calendars
`list_events`	List or search events (supports time range, free-text query)
`create_event`	Create an event (supports attendees, location, description)
`modify_event`	Patch an existing event (only provided fields are updated)