Provides OAuth authentication with Google accounts for accessing Google services.
Enables creating events in Google Calendar with customizable attributes including start/end times, descriptions, locations, attendees, and timezone settings.
Requires setup through Google Cloud Console to enable API access and create OAuth credentials for the integration.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GoogleCalendarMCPcreate a meeting tomorrow at 2pm for 1 hour about project planning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 Workspace Server
Installation
Clone this repository:
git clone https://github.com/ITworkonline/GoogleCalendarMCP.git
cd GoogleCalendarMCPCreate 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