GoogleCalendarMCP

A Model Completion Prompt (MCP) plugin for interacting with Google Calendar.

Features

Create events in Google Calendar with customizable:
- Start and end times
- Description
- Location
- Attendees
- Timezone

Related MCP server: mcp-google

Installation

Clone this repository:

git clone https://github.com/ITworkonline/GoogleCalendarMCP.git cd GoogleCalendarMCP

Create a virtual environment and install dependencies:

python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -e .

Set up Google Calendar API:
- Go to the Google Cloud Console
- Create a new project
- Enable the Google Calendar API
- Create OAuth 2.0 credentials (Desktop app)
- Download the credentials JSON file and save it as credentials.json in the project root

Usage

from GoogleCalendarMCP.main import create_event # Create a calendar event result = await create_event( summary="Meeting with Team", start_time="2025-04-01T10:00:00", end_time="2025-04-01T11:00:00", description="Discuss project progress", location="Conference Room 3", attendees=["colleague@example.com"], timezone="America/New_York" )

Authentication

The first time you run the program, it will open a browser window for you to authenticate with your Google account. After authentication, a token.json file will be created to store your credentials for subsequent runs.