Google Workspace MCP Server

Name: Google Workspace MCP Server
Author: trymeuj

@trymeuj

Repository

About Google Workspace MCP Server

No overview available yet

#gmail #mcp-server #google-workspace

Basic information

Config

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

{
  "mcpServers": {
    "gmail-mcp-server-3": {
      "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?

It is a Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events through the MCP interface.

How to use Google Workspace MCP Server?

Clone the repository, run npm install, then set up OAuth 2.0 credentials via Google Cloud Console. Run node get-refresh-token.js to obtain a refresh token, configure the MCP settings file with environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN), build with npm run build, and then invoke tools through MCP.

Key features of Google Workspace MCP Server

List recent emails with optional filtering
Advanced email search using Gmail query syntax
Send emails with support for CC and BCC
Modify email labels (archive, trash, mark read/unread)
List upcoming calendar events with date range filtering
Create, update, and delete calendar events with attendees

Use cases of Google Workspace MCP Server

Automate retrieving unread emails from your inbox
Search for emails with attachments from specific senders
Send programmatic emails with CC and BCC recipients
Archive or mark emails read/unread in bulk
Schedule and manage calendar events with attendees

FAQ from Google Workspace MCP Server

What are the prerequisites for setting up Google Workspace MCP Server?

You need Node.js version 14 or higher, a Google Cloud Console project with the Gmail API and Google Calendar API enabled, and OAuth 2.0 credentials (client ID and secret) with http://localhost:4100/code as an authorized redirect URI.

How do I obtain a refresh token?

Run node get-refresh-token.js in the project root. This opens a browser for Google OAuth authentication, requests the required scopes, saves credentials to token.json, and displays the refresh token in the console.

What OAuth scopes does the server request?

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

How do I configure the MCP settings for the server?

Add an entry to the mcpServers object in your MCP settings file (VSCode Claude extension or Claude desktop app), specifying the command node, the path to build/index.js, and environment variables for your Google client ID, client secret, and refresh token.

What should I do if I encounter authentication errors?

Verify that all required OAuth scopes are granted, that your client ID and secret are correct, and that the refresh token is still valid. Also check the Google Cloud Console for API quotas and ensure the Gmail and Calendar APIs are enabled.