Google Workspace MCP Server
by epaproditus
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.
Last updated: N/A
What is Google Workspace MCP Server?
The Google Workspace MCP Server is a Node.js application that acts as a Model Context Protocol (MCP) server, allowing users to interact with Gmail and Google Calendar APIs programmatically. It provides a set of tools to manage emails and calendar events through a defined interface, enabling automation and integration with other systems.
How to use Google Workspace MCP Server?
To use the server, you need to set up a Google Cloud project, enable the Gmail and Calendar APIs, and create OAuth 2.0 credentials. After cloning the repository and installing dependencies, you'll need to configure the server with your credentials and refresh token. Finally, you can build and run the server and configure your MCP settings to point to it.
Key features of Google Workspace MCP Server
List recent emails with filtering
Advanced email search with Gmail query syntax
Send new emails with CC and BCC support
Modify email labels (archive, trash, mark read/unread)
List upcoming calendar events with date range filtering
Create new calendar events with attendees
Update existing calendar events
Delete calendar events
Use cases of Google Workspace MCP Server
Automated email processing and filtering
Programmatic calendar event management
Integration with other applications via MCP
Building custom workflows for Gmail and Calendar
Creating automated reminders and notifications
FAQ from Google Workspace MCP Server
What is MCP?
What is MCP?
MCP stands for Model Context Protocol. It's a protocol that allows different applications to communicate and share data.
What are the required Google API scopes?
What are the required Google API scopes?
The required scopes are https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.
How do I get a refresh token?
How do I get a refresh token?
Run the node get-refresh-token.js script after configuring your OAuth credentials. This will open a browser window for authentication and save the refresh token to token.json.
Where do I configure the MCP settings?
Where do I configure the MCP settings?
The MCP settings are typically configured in the settings file of your MCP client, such as the VSCode Claude extension or the Claude desktop app. The README provides example paths for these.
What do I do if I get an authentication error?
What do I do if I get an authentication error?
Ensure that all required OAuth scopes are granted, verify that your client ID and secret are correct, and check if your refresh token is still valid. Also, make sure you have enabled the Gmail and Calendar APIs in your Google Cloud project.