Record · google-worksMCP serverOpen sourceVerified Sep 23, 2026

Google Workspace MCP Server

Natural-language control of Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts and Chat.

Visit Google Workspace MCP Server →View source

Sources and review

Checked against public documentation on September 23, 2026. Suitability guidance is our editorial judgment; this is not a performance benchmark or an endorsement.

Best for

Assistants that need to read and act across a whole Google Workspace, or a team hosting one shared server.

Avoid if

You can't create Google OAuth client credentials; the server requires a client ID and secret.

About Google Workspace MCP Server

This community Google Workspace MCP server covers Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts and Chat, with fine-grained editing tools and tool tiers to limit how many tools load. It supports OAuth 2.1 with multi-user and stateless deployment for central hosting, works with free Google accounts and Workspace plans, and includes a CLI.

Google Workspace MCP Server is an open-source project written primarily in Python, with 3.2k stars on GitHub. It was last updated in September 2026.

Add Google Workspace MCP Server to your MCP client

Generated from the launch command in the project's README. Your client starts the server on demand. Replace <client-id> and <client-secret> with your own values first.

Claude CodeRun in your terminal

claude mcp add google-workspace-mcp -e 'GOOGLE_OAUTH_CLIENT_ID=<client-id>' -e 'GOOGLE_OAUTH_CLIENT_SECRET=<client-secret>' -- uvx workspace-mcp --tool-tier core

Cursor~/.cursor/mcp.json or .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<client-id>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<client-secret>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "google-workspace-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<client-id>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<client-secret>"
      }
    }
  }
}

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<client-id>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<client-secret>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.google-workspace-mcp]
command = "uvx"
args = ["workspace-mcp", "--tool-tier", "core"]
env = { GOOGLE_OAUTH_CLIENT_ID = "<client-id>", GOOGLE_OAUTH_CLIENT_SECRET = "<client-secret>" }

Check the project's README for required accounts, keys and permissions before connecting. Setup guide for each client →

For agent buildersMake your product part of the discovery.Explore advertising

Google Workspace MCP Server vs. the alternatives

All 163 alternatives →

Record	Stars	Language	License	Pricing
Google Workspace MCP ServerMCP serverthis listing	3.2k	Python	MIT	Open source
MCP Reference ServersMCP server	91k	TypeScript	MIT AND Apache-2.0	Open source
context7MCP server	62k	TypeScript	MIT	Open source
chrome-devtools-mcpMCP server	53k	TypeScript	Apache-2.0	Open source
Playwright MCPMCP server	37k	TypeScript	Apache-2.0	Open source
github-mcp-serverMCP server	33k	Go	MIT	Open source

See all 163 Google Workspace MCP Server alternatives, compared →