Google Workspace MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Features
Gmail Tools
list_emails: List recent emails from your inbox with optional filtering
search_emails: Advanced email search with Gmail query syntax
send_email: Send new emails with support for CC and BCC
modify_email: Modify email labels (archive, trash, mark read/unread)
Calendar Tools
list_events: List upcoming calendar events with date range filtering
create_event: Create new calendar events with attendees
update_event: Update existing calendar events
delete_event: Delete calendar events
Prerequisites
- Node.js: Install Node.js version 14 or higher
- Google Cloud Console Setup:
Setup Instructions
- Clone and Install:
- Create OAuth Credentials:
Create a
credentials.jsonfile in the root directory:
- Get Refresh Token:This will:
- Configure MCP Settings:
Add the server configuration to your MCP settings file:Add this to the
mcpServersobject:
- Build and Run:
Usage Examples
Gmail Operations
- List Recent Emails:
- Search Emails:
- Send Email:
- Modify Email:
Calendar Operations
- List Events:
- Create Event:
- Update Event:
- Delete Event:
Troubleshooting
- Authentication Issues:
- API Errors:
License
This project is licensed under the MIT License.
Google Workspace MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Features
Gmail Tools
list_emails: List recent emails from your inbox with optional filtering
search_emails: Advanced email search with Gmail query syntax
send_email: Send new emails with support for CC and BCC
modify_email: Modify email labels (archive, trash, mark read/unread)
Calendar Tools
list_events: List upcoming calendar events with date range filtering
create_event: Create new calendar events with attendees
update_event: Update existing calendar events
delete_event: Delete calendar events
Prerequisites
- Node.js: Install Node.js version 14 or higher
- Google Cloud Console Setup:
Setup Instructions
- Clone and Install:
- Create OAuth Credentials:
Create a
credentials.jsonfile in the root directory:
- Get Refresh Token:This will:
- Configure MCP Settings:
Add the server configuration to your MCP settings file:Add this to the
mcpServersobject:
- Build and Run:
Usage Examples
Gmail Operations
- List Recent Emails:
- Search Emails:
- Send Email:
- Modify Email:
Calendar Operations
- List Events:
- Create Event:
- Update Event:
- Delete Event:
Troubleshooting
- Authentication Issues:
- API Errors:
License
This project is licensed under the MIT License.