Google Workspace MCP Server logo

Google Workspace MCP Server

by aaronsb

The Google Workspace MCP server puts you in control of your Google Workspace by securely connecting your account. It simplifies tasks like managing Gmail, Calendar, and Drive, allowing you to focus on productivity rather than technical details.

View on GitHub

Last updated: N/A

What is Google Workspace MCP Server?

The Google Workspace MCP Server is a Model Context Protocol server designed to streamline and automate interactions with Google Workspace services like Gmail, Calendar, and Drive. It provides a secure and simplified interface for managing your Google Workspace data and tasks.

How to use Google Workspace MCP Server?

To use the server, you need to create a Google Cloud Project, enable the necessary APIs (Gmail, Calendar, Drive), configure the OAuth consent screen, and create OAuth 2.0 credentials. Then, configure your MCP settings (e.g., in Cline) with the server details and credentials. The server can then be used to manage your Google Workspace accounts and data through various commands and operations.

Key features of Google Workspace MCP Server

  • Simplified attachment handling with automatic metadata management

  • Streamlined email responses focused on essential information

  • Robust attachment indexing and retrieval system

  • Efficient file management across Gmail and Calendar

Use cases of Google Workspace MCP Server

  • Automating email filtering and labeling

  • Scheduling and managing calendar events

  • Organizing and searching files in Google Drive

  • Integrating Google Workspace with AI assistants like Cline

FAQ from Google Workspace MCP Server

How do I set up the Google Cloud Project?

Go to the Google Cloud Console, create a new project, enable the Gmail, Calendar, and Drive APIs, configure the OAuth consent screen, and create OAuth 2.0 credentials.

What are the required API scopes?

You need to add the required scopes for Gmail, Calendar, and Drive when configuring the OAuth consent screen.

Where do I store the OAuth Client ID and Secret?

Configure the OAuth credentials in your MCP settings file (e.g., Cline settings).

What is the purpose of the accounts.json file?

The accounts.json file in the mounted config directory is required. For first-time setup, copy accounts.example.json to accounts.json in your config directory before starting the container.

What if I encounter authentication errors?

Verify your Google Cloud project is properly configured, ensure you've added yourself as a test user in the OAuth consent screen, check that both Gmail API and Google Calendar API are enabled, and verify credentials in MCP settings match your OAuth client configuration.