Google Workspace MCP Server

What is Google Workspace MCP Server?

A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. It enables managing emails and calendar events programmatically through the MCP interface.

How to use Google Workspace MCP Server?

Requires Node.js 14+, a Google Cloud project with Gmail API and Calendar API enabled, and OAuth 2.0 credentials. Clone the repository, install dependencies, create a credentials.json, run node get-refresh-token.js to get a refresh token, configure the MCP settings file with environment variables, then build and run.

Key features of Google Workspace MCP Server

• List, search, send, and modify Gmail emails
• List, create, update, and delete Calendar events
• Gmail email labeling (archive, trash, mark read/unread)
• Calendar event support for attendees and date filtering
• OAuth 2.0 authentication with refresh token

Use cases of Google Workspace MCP Server

• Automate email management: list unread, send, archive
• Search emails using Gmail query syntax
• Manage calendar events: create meetings with attendees
• Update or delete existing calendar events programmatically

FAQ from Google Workspace MCP Server

What prerequisites are required?

Node.js version 14 or higher, a Google Cloud project with the Gmail API and Calendar API enabled, and OAuth 2.0 credentials (Client ID, Client Secret).

How do I authenticate with Google?

You must create a credentials.json file and run node get-refresh-token.js, which opens a browser for OAuth consent. The refresh token is saved to token.json and displayed.

What Google OAuth scopes are requested?

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

How is the server configured in an MCP host?

Add a configuration entry to your MCP settings file with the command node, the path to build/index.js, and environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.

What if I get API errors?

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