MCP server

Google Workspace MCP Server

Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms and Chat in one server. Community-maintained (taylorwilsdon on GitHub), not by the company whose product it connects to. It runs locally on your machine over stdio. Setup below for 12 clients (checked 2026-10-25). Repo and registry data checked 2026-10-24.

Maintainer: Community
Runs: Local (stdio)
Repo: taylorwilsdon/google_workspace_mcp
GitHub: ★ 3,407, last push 2026-10-24 (checked 2026-10-24)
License: MIT
Connects to: Gmail, Google Calendar, Google Chat, Google Docs, Google Drive, Google Forms, Google Sheets, Google Slides

Install the Google Workspace MCP Server

Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.

Run in a terminal. Everything after -- is the command that starts the server. docs

claude mcp add --transport stdio google-workspace -- uvx workspace-mcp

Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Add to Cursor

Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs

{
  "servers": {
    "google-workspace": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Add to VS Code

Run codex mcp add google-workspace -- uvx workspace-mcp, or add this to ~/.codex/config.toml. docs

[mcp_servers.google-workspace]
command = "uvx"
args = ["workspace-mcp"]

Run in a terminal (-s user adds it for all projects; the default is this project). docs

gemini mcp add -s user google-workspace uvx workspace-mcp

Run in a terminal; it writes ~/.copilot/mcp-config.json. docs

copilot mcp add google-workspace -- uvx workspace-mcp

Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs

{
  "context_servers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "google-workspace": {
      "type": "local",
      "command": [
        "uvx",
        "workspace-mcp"
      ],
      "enabled": true
    }
  }
}

Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ]
    }
  }
}

Security notes

The local server runs with your user's permissions (uvx downloads it from PyPI on first run).
Content it reads from the app (tasks, pages, comments) can carry prompt-injection instructions. Keep approval prompts on for anything that writes.
Community code: read it (or at least the tools it registers) before you give it credentials.

Alternatives

all productivity MCP servers →

Google Calendarofficial
Google's hosted server for listing, creating and updating Google Calendar events (developer preview).
Notionofficial · ★ 4.7k
Search, read and edit pages and databases in your Notion workspace.
WordPress MCP Adapterofficial · ★ 1.9k
WordPress plugin that turns registered site abilities into MCP tools for self-hosted sites.
Atlassian (Jira & Confluence)official · ★ 1.1k
Jira issues and Confluence pages in Atlassian Cloud, hosted with OAuth.
Todoistofficial · ★ 563
Add, find and complete Todoist tasks and projects.
monday.comofficial · ★ 435
Boards, items, updates and docs in monday.com.
Contentfulofficial · ★ 60
Manage Contentful entries, assets, content types and spaces through the Management API.
Apollo.ioofficial · ★ 32
Hosted server to find and enrich prospects and manage Apollo sequences.

Comparing servers for one product? Google Forms MCP servers

FAQ

What does the Google Workspace MCP Server do?+

Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms and Chat in one server.

Is the Google Workspace MCP server official?+

Community-maintained (taylorwilsdon on GitHub), not by the company whose product it connects to.

How do I add Google Workspace to Claude Code?+

Run: claude mcp add google-workspace -- uvx workspace-mcp. Add --scope project to share it with your team through .mcp.json.

How do I use the Google Workspace MCP server in Cursor or VS Code?+

Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").

Does Google Workspace work in ChatGPT and claude.ai?+

No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.

What are the alternatives to the Google Workspace MCP server?+

Other productivity MCP servers: Google Calendar, Notion, WordPress MCP Adapter, Atlassian (Jira & Confluence) and Todoist.

All MCP servers · What is an MCP server? · Agent skills