mcp-google-calendar

MCP.Pizza Chef: markelaugust74

The mcp-google-calendar server is a Model Context Protocol implementation that integrates Google Calendar with AI assistants such as Claude. It enables creating, updating, and managing calendar events programmatically, including setting titles, descriptions, start/end times, and adding attendees. The server supports OAuth2 authentication with Google Calendar API, ensuring secure access. It fully implements the MCP protocol, allowing real-time, structured interaction between AI models and calendar data. This server is ideal for automating scheduling tasks and enhancing AI-driven productivity workflows.

Use This MCP server To

Create Google Calendar events via AI assistants Manage event details like time, description, and attendees Automate scheduling workflows with AI integration Enable OAuth2-secured calendar access for AI models Debug and troubleshoot calendar event creation processes

README

MCP Google Calendar Server

A Model Context Protocol (MCP) server implementation that enables AI assistants like Claude to create and manage Google Calendar events.

Features

Create calendar events with title, description, start/end times
Support for adding event attendees
OAuth2 authentication with Google Calendar API
Full MCP protocol implementation
Debug logging for troubleshooting

Prerequisites

Node.js v18 or later
Google Cloud Console project with Calendar API enabled
OAuth2 credentials (Client ID and Client Secret)

Setup

Clone the repository:

git clone [https://github.com/markelaugust74/mcp-google-calendar.git] 
cd mcp-google-calendar

Install dependencies:

npm install

Set up environment variables:

Copy .env.example to .env
Add your Google OAuth2 credentials

Get your refresh token:

npm run auth

Update the refresh token in index.js

Usage

npm start

mcp-google-calendar FAQ

How do I authenticate the mcp-google-calendar server with Google Calendar?

You must create OAuth2 credentials in the Google Cloud Console, then provide the Client ID, Client Secret, and obtain a refresh token using the provided authentication script.

What Node.js version is required to run the mcp-google-calendar server?

Node.js version 18 or later is required to ensure compatibility with dependencies and features.

Can I add attendees to calendar events using this MCP server?

Yes, the server supports adding multiple event attendees when creating or updating events.

How does the mcp-google-calendar server handle security?

It uses OAuth2 authentication with Google Calendar API, ensuring secure and scoped access to calendar data.

Is debug logging available for troubleshooting?

Yes, the server includes debug logging to help diagnose issues during event creation or management.

Can this MCP server be used with AI models other than Claude?

Yes, it is compatible with any AI assistant or model that supports the MCP protocol, including OpenAI's GPT-4 and Anthropic's Claude.

How do I set up environment variables for the server?

Copy the .env.example file to .env and fill in your Google OAuth2 credentials and refresh token as instructed in the setup guide.

Does the server support full MCP protocol implementation?

Yes, it fully implements the MCP protocol to enable structured, real-time interaction with AI models.