Google Workspace MCP Server

Name: Google Workspace MCP Server
Author: epaproditus

@epaproditus

Repository

About Google Workspace MCP Server

A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)

#google-workspace #mcp #gmail #calendar #integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "node",
      "args": [
        "get-refresh-token.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.