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: Google Calendar MCP Server

Installation

1. Clone this repository:

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

2. Create a virtual environment and install dependencies:

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

3. 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.

License

MIT