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
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.jsonin 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.
License
MIT