Google Workspace MCP Server

A Model Context Protocol server

Local serverstdioGo

What is the Google Workspace MCP server?

A Model Context Protocol server. The google workspace mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 8 defined tools rather than through you.

What it actually does

A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.

Its toolset

Everything the assistant can do here goes through one of these:

  • list_emails — List recent emails from your inbox with optional filtering
  • search_emails — Advanced email search with 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

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Configuration

You will need 5 environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN, YOUR_CLIENT_ID, YOUR_CLIENT_SECRET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  1. Node.js: Install Node.js version 14 or higher 2. Google Cloud Console Setup: - Go to Google Cloud Console - Create a new project or select an existing one - Enable the Gmail API and Google Calendar API: 1. Go to "APIs & Services" > "Library" 2. Search for and enable "Gmail API" 3. Search for and enable "Google Calendar API" - Set up OAuth 2.0

When to reach for it

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Google Workspace's toolset — list_emails, search_emails, send_email and 5 more — is a fair guide to whether it matches your workflow. It is maintained by epaproditus; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the google workspace mcp server does with a few real requests.

Available tools

ToolWhat it does
list_emailsList recent emails from your inbox with optional filtering
search_emailsAdvanced email search with Gmail query syntax
send_emailSend new emails with support for CC and BCC
modify_emailModify email labels (archive, trash, mark read/unread)
list_eventsList upcoming calendar events with date range filtering
create_eventCreate new calendar events with attendees
update_eventUpdate existing calendar events
delete_eventDelete calendar events

How to install the Google Workspace MCP server

{
     "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"
         }
       }
     }
   }

Configuration as documented by the project. Restart the client after saving.

Configuration

  1. Node.js: Install Node.js version 14 or higher 2. Google Cloud Console Setup: - Go to Google Cloud Console - Create a new project or select an existing one - Enable the Gmail API and Google Calendar API: 1. Go to "APIs & Services" > "Library" 2. Search for and enable "Gmail API" 3. Search for and enable "Google Calendar API" - Set up OAuth 2.0
VariableDescriptionRequired
GOOGLE_CLIENT_IDConfiguration value read at startup.Optional
GOOGLE_CLIENT_SECRETCredential the server authenticates with.Yes
GOOGLE_REFRESH_TOKENCredential the server authenticates with.Yes
YOUR_CLIENT_IDConfiguration value read at startup.Optional
YOUR_CLIENT_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • Use Google Workspace to list emails.
  • Use Google Workspace to search emails.
  • Use Google Workspace to send email.

Frequently asked questions

It connects Google Workspace to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (list_emails, search_emails, send_email, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Google Workspace directly.