Provides comprehensive email management capabilities including listing, searching, reading, and sending emails with support for advanced Gmail search syntax and automatic email summarization
Enables full calendar management with features for listing calendars, creating single and recurring events, retrieving events with filtering options, and automatic smart color coding based on event content
Google Workspace MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to Google Calendar and Gmail APIs. This server enables AI assistants like Ada to manage your calendar events and email seamlessly.
Features
📅 Google Calendar Integration
List Calendars: View all available calendars
List Events: Retrieve events with filtering by date range, calendar, etc.
Create Events: Schedule single events with automatic color coding
Create Recurring Events: Schedule recurring events using RRULE patterns
Smart Color Coding: Automatic event color suggestions based on content
📧 Gmail Integration
List Emails: Retrieve emails with advanced filtering
Get Email Content: Fetch full email content and metadata
Send Emails: Compose and send emails with CC/BCC support
Search Emails: Use Gmail's powerful search syntax
Email Summarization: AI automatically summarizes email content
Prerequisites
Node.js (v18.18 or higher)
Google Cloud Project with Calendar and Gmail APIs enabled
OAuth2 Credentials downloaded as
credentials.json
Setup
Clone the repository:
git clone <your-repo-url> cd google-cal-cliInstall dependencies:
npm installSet up Google Cloud:
Create a Google Cloud project
Enable Calendar API and Gmail API
Create OAuth2 credentials (Desktop application)
Download credentials as
credentials.json
in the project root
Environment variables: Create a
.env
file with:OPENAI_API_KEY=your_openai_api_key_hereBuild the project:
npm run build
Usage
Start the MCP Server
Start the Chat Client
Development Mode
API Scopes
The server requests the following Google API scopes:
https://www.googleapis.com/auth/calendar
- Full calendar accesshttps://www.googleapis.com/auth/gmail.readonly
- Read Gmail accesshttps://www.googleapis.com/auth/gmail.send
- Send Gmail access
Available Tools
Calendar Tools
list_calendars
- List available calendarslist_events
- List events with filteringcreate_event
- Create single eventscreate_recurring_event
- Create recurring events
Gmail Tools
list_emails
- List emails with filteringget_email
- Retrieve email contentsend_email
- Send emailssearch_emails
- Search emails with Gmail syntax
Color Coding
Events are automatically color-coded based on content:
Work/Professional: Blue tones (9=Blueberry, 7=Peacock, 8=Graphite)
Social/Fun: Pink/Red tones (4=Flamingo, 11=Tomato, 3=Grape)
Health/Wellness: Green tones (10=Basil, 2=Sage)
Learning/Education: Yellow/Orange tones (5=Banana, 6=Tangerine)
Travel: 7=Peacock
Default: 1=Lavender
Gmail Search Syntax
Use Gmail's powerful search operators:
from:example@gmail.com
- Emails from specific sendersubject:meeting
- Emails with specific subjectis:unread
- Unread emailshas:attachment
- Emails with attachmentslabel:important
- Emails with specific labels
Project Structure
Contributing
Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request
License
This project is licensed under the MIT License.
Security Note
Never commit credentials.json
, token.json
, or .env
files to version control. These files contain sensitive authentication information.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to manage Google Calendar events and Gmail emails through natural language. Supports creating/listing calendar events with smart color coding, sending/reading emails, and advanced search capabilities across both services.