mcp-google-calendar
by: markelaugust74
A Model Context Protocol (MCP) server implementation for Google Calendar integration. Create and manage calendar events directly through Claude or other AI assistants.
📌Overview
Purpose: This framework facilitates the integration of AI assistants with Google Calendar, enabling them to create and manage calendar events seamlessly.
Overview: The MCP Google Calendar Server is a Model Context Protocol implementation designed to empower AI assistants like Claude with the ability to interface directly with Google Calendar. It allows users to manage calendar events efficiently by providing the necessary backend infrastructure and API interactions.
Key Features:
-
Event Creation: Create calendar events with essential details such as title, description, and start/end times, enabling comprehensive event management.
-
Attendee Management: Support for adding event attendees, facilitating collaborative scheduling and invitations.
-
OAuth2 Authentication: Securely authenticate with the Google Calendar API, ensuring safe and authorized access to user calendar data.
-
Full MCP Protocol Implementation: Adheres to the Model Context Protocol standards, ensuring robust communication and interoperability.
-
Debug Logging: Provides logging capabilities for troubleshooting, aiding developers in diagnosing and addressing issues during development and deployment.
MCP Google Calendar Server
A Model Context Protocol (MCP) server implementation that enables AI assistants 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
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
- Copy
-
Get your refresh token:
npm run auth
-
Update the refresh token in
index.js
.
Usage
npm start