Google Workspace MCP Server logo

Google Workspace MCP Server

by trymeuj

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.

View on GitHub

Last updated: N/A

What is Google Workspace MCP Server?

The Google Workspace MCP Server is a server that allows you to interact with the Gmail and Calendar APIs using the Model Context Protocol (MCP). It provides a programmatic interface for managing emails and calendar events.

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, configure OAuth 2.0 credentials, clone the repository, install dependencies, configure the server with your credentials, and then build and run the server. Detailed setup instructions are provided in the README.

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

  • Automating email management tasks

  • Programmatically creating and managing calendar events

  • Integrating Gmail and Calendar functionality into other applications

  • Building custom workflows for interacting with Google Workspace

  • Using MCP to streamline interactions with Google services

FAQ from Google Workspace MCP Server

What do I do if I have authentication issues?

Ensure all required OAuth scopes are granted, verify client ID and secret are correct, and check if the refresh token is valid.

What do I do if I encounter API errors?

Check the Google Cloud Console for API quotas and limits, ensure APIs are enabled for your project, and verify request parameters match the required format.

What version of Node.js is required?

Node.js version 14 or higher is required.

Where do I configure the MCP settings?

The MCP settings are configured in your MCP settings file, such as ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json for VSCode Claude extension or ~/Library/Application Support/Claude/claude_desktop_config.json for Claude desktop app.

What OAuth scopes are required?

https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/gmail.send