Integrations
Enables interaction with Google Calendar, allowing users to create events, list upcoming events, and analyze their schedule. Provides access to calendar event data including titles, times, descriptions, and attendees.
Leverages Google Cloud authentication and APIs to access Google Calendar data, requiring a Google Cloud Project with Calendar API enabled and OAuth 2.0 Client credentials.
Google Calendar MCP Server
Interact with your Google Calendar through Claude Desktop using the Model Context Protocol (MCP).
This is a TypeScript-based MCP server that implements Google Calendar integration. It demonstrates core MCP concepts while providing:
- Calendar event management through MCP URIs
- Tools for creating and modifying events
- Prompts for generating calendar insights
Features
Resources
- Access calendar events via MCP URIs
- Each event has title, time, description, and attendees
- Structured event data with proper mime types
Tools
create_event
- Create new calendar events- Takes title, time, and other event details as parameters
- Directly interfaces with Google Calendar API
list_events
- View upcoming calendar events- [Add other tools you've implemented]
Prompts
analyze_schedule
- Generate insights about your calendar- Includes upcoming events as embedded resources
- Returns structured prompt for LLM analysis
- [Add other prompts you've implemented]
Prerequisites
- Node.js (v14 or higher)
- A Google Cloud Project with Calendar API enabled
- OAuth 2.0 Client credentials
Development
Install devbox by following instructions at devbox.sh
Initialize devbox in the project directory:
Start the devbox shell:
Install dependencies:
Build the server:
For development with auto-rebuild:
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
First-Time Setup
- Set up Google Cloud credentials:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Calendar API
- Create OAuth 2.0 credentials (Desktop application type)
- Download the client secret JSON file
- Rename it to
.client_secret.json
and place it in the project root
- Initial Authentication:
- When first running the server, it will provide an authentication URL
- Visit the URL in your browser
- Grant the requested permissions
- Copy the provided authorization code
- Paste the code back into the CLI prompt
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Allows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.
Related Resources
Related MCP Servers
- -securityAlicense-qualityServer for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.Last updated -226JavaScriptMIT License
- -securityAlicense-qualityEnables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.Last updated -131TypeScriptMIT License
- -securityFlicense-qualityModel Context Protocol server that provides seamless access to Google Calendar API with asynchronous operation support, enabling efficient calendar management through a standardized interface.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.Last updated -13321TypeScriptMIT License