Google Calendar

An MCP server for Google Calendar, enabling LLMs to read, create, and manage calendar events.

This is a Model Context Protocol (MCP) server that provides integration with Google Calendar. It allows LLMs to read, create, and manage calendar events through a standardized interface.

- List available calendars
- List events from a calendar
- Create new calendar events
- Update existing events
- Delete events
- Process events from screenshots and images
- Node.js 16 or higher
- TypeScript 5.3 or higher
- A Google Cloud project with the Calendar API enabled
- OAuth 2.0 credentials (Client ID and Client Secret)

google-calendar-mcp/ ├── src/ # TypeScript source files ├── build/ # Compiled JavaScript output ├── llm/ # LLM-specific configurations and prompts ├── package.json # Project dependencies and scripts └── tsconfig.json # TypeScript configuration

- Go to theGoogle Cloud Console
- Create a new project or select an existing one.
- Enable theGoogle Calendar APIfor your project. Ensure that the right project is selected from the top bar before enabling the API.
- Create OAuth 2.0 credentials:

npm install

npm start

{ "mcpServers": { "google-calendar": { "command": "node", "args": ["path/to/build/index.js"] } } }

Along with the normal capabilities you would expect for a calendar integration you can also do really dynamic things like add events from screenshots and images and much more.

Add this event to my calendar based on the attached screenshot.

Supported image formats: PNG, JPEG, GIF Images can contain event details like date, time, location, and description

Which events tomorrow have attendees who have not accepted the invitation?

Here's some available that was provided to me by someone I am interviewing. Take a look at the available times and create an event for me to interview them that is free on my work calendar.

Please provide availability looking at both my personal and work calendar for this upcoming week. Choose times that work well for normal working hours on the East Coast. Meeting time is 1 hour

-

OAuth Token expires after one week (7 days)

- Apps that are in testing mode, rather than production, will need to go through the OAuth flow again after a week.

- Ensure yourgcp-oauth.keys.jsonis correctly formatted
- Try deleting.gcp-saved-tokens.jsonand re-authenticating

- Make sure all dependencies are installed:npm install
- Check your Node.js version matches prerequisites
- Clear the build directory:rm -rf build/

- Verify the image format is supported
- Ensure the image contains clear, readable text

- The server runs locally and requires OAuth authentication
- OAuth credentials should be stored ingcp-oauth.keys.jsonin the project root
- Authentication tokens are stored in.gcp-saved-tokens.jsonwith restricted file permissions
- Tokens are automatically refreshed when expired
- Never commit your OAuth credentials or token files to version control
- For production use, get your OAuth application verified by Google

A command-line tool to fetch Google Calendar schedules and convert them into custom prompts or text snippets using a template engine.

Integrates with Google Calendar to manage events, reminders, and schedules using OAuth 2.0.

Interact with Google Calendar APIs to manage events and calendars.

Interact with Google Calendar to manage events, schedules, and meetings.

Integrates with the Google Calendar API to read, create, update, and delete calendar events.

Integrates with Google Calendar to manage events and generate calendar insights.

Integrates with Google Calendar to read, create, update, and search for calendar events.

Interact with Google Calendar to list events, create meetings, and find free time slots.

A server for managing Google Calendar events and schedules.

Integrate Google services like Gmail, Calendar, Drive, and Tasks with MCP.