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

1. Clone this repository:

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

1. Create a virtual environment and install dependencies:

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

1. Set up Google Calendar API:
2. Go to the Google Cloud Console
3. Create a new project
4. Enable the Google Calendar API
5. Create OAuth 2.0 credentials (Desktop app)
6. 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.

License

MIT