How do I install the google workspace mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

The recorded environment keys are `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `GOOGLE_REFRESH_TOKEN`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

Google Workspace MCP Server

A Model Context Protocol server

Local serverstdioGo

What is the Google Workspace MCP Server?

A Model Context Protocol server

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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

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_GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "YOUR_GOOGLE_REFRESH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

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

Variable	Description	Required
GOOGLE_CLIENT_ID	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_CLIENT_SECRET	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_REFRESH_TOKEN	Declared in the maintainer’s client configuration.	Check documentation

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

A Model Context Protocol server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.