Home / MCP / Google Workspace MCP Server

Google Workspace MCP Server

Provides tools to manage Gmail and Google Calendar data via MCP (list/search/send/modify emails; list/create/update/delete events).

JavaScript

26stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "gsuite_mcp": {
            "command": "node",
            "args": [
                "/path/to/google-workspace-server/build/index.js"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID",
                "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
                "GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
            }
        }
    }
}

You can manage your Gmail and Google Calendar programmatically through a dedicated MCP server. It exposes tools to read and send emails, label management, and calendar event operations, all accessible via the MCP interface to automate workflows and integrate with your apps.

How to use

You connect to the MCP server from your MCP client and call its Gmail and Calendar tools to perform common tasks. With Gmail tools you can list emails, search with Gmail syntax, send messages, and modify labels. With Calendar tools you can list events, create new ones with attendees, update existing events, and delete events. Start by authenticating with the configured Google OAuth credentials, then invoke the available tools to integrate Gmail and Calendar actions into your automation flows.

How to install

# Prerequisites
node --version
# Ensure Node.js 14+ is installed

# 1) Install dependencies for the server (example project flow)
npm install

# 2) Build the MCP server if a build step exists
npm run build

# 3) Run the server (stdio configuration is shown in the config snippet)
npx -y @smithery/cli install @rishipradeep-think41/gsuite-mcp --client claude

Additional configuration and notes

Configure OAuth credentials and environment values in your MCP settings to enable secure access to Gmail and Calendar APIs. The setup requires a Google Cloud project with Gmail API and Google Calendar API enabled, and OAuth 2.0 credentials created for a web application. The redirect URI used during OAuth is http://localhost:4100/code. You must supply the Client ID, Client Secret, and a refresh token as part of the MCP environment.

MCP server configuration (stdio)

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/google-workspace-server/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Available tools

list_emails

List recent emails from your inbox with optional filtering

search_emails

Advanced email search using Gmail query syntax

send_email

Send new emails with support for CC and BCC

modify_email

Modify email labels (archive, trash, mark read/unread)

list_events

List upcoming calendar events with date range filtering

create_event

Create new calendar events with attendees

update_event

Update existing calendar events

delete_event

Delete calendar events