Google Workspace MCP Server
by MCP-Mirror
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?
This is a Model Context Protocol (MCP) server designed to facilitate interaction with Google Workspace services, specifically Gmail and Calendar. It allows users to programmatically manage emails and calendar events through a defined interface.
How to use Google Workspace MCP Server?
To use this server, you need to set up a Google Cloud project, enable the Gmail and Calendar APIs, and configure OAuth 2.0 credentials. After cloning the repository and installing dependencies, you'll need to create a credentials.json file with your client ID and secret, obtain a refresh token, and configure the server within your MCP settings. Finally, build and run the server.
Key features of Google Workspace MCP Server
List recent emails with filtering
Advanced email search using 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 are the prerequisites for using this server?
What are the prerequisites for using this server?
You need Node.js (version 14 or higher) and a Google Cloud project with Gmail and Calendar APIs enabled.
How do I set up OAuth 2.0 credentials?
How do I set up OAuth 2.0 credentials?
Go to the Google Cloud Console, navigate to 'APIs & Services' > 'Credentials', and create an OAuth client ID for a web application. Ensure you set the authorized redirect URI.
What permissions are required for the Google OAuth authentication?
What permissions are required for the Google OAuth authentication?
The server requires the following permissions: https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send.
Where do I configure the MCP settings?
Where do I configure the MCP settings?
The MCP settings are configured in the cline_mcp_settings.json file for VSCode Claude extension or the claude_desktop_config.json file for the Claude desktop app.
What should I do if I encounter authentication issues?
What should I do if I encounter authentication issues?
Ensure all required OAuth scopes are granted, verify your client ID and secret are correct, and check if your refresh token is valid.