Google Workspace MCP — Gmail Drive Calendar for AI

What it is

Google Workspace MCP is an official CLI tool with a built-in MCP (Model Context Protocol) server for Google Workspace APIs. One command starts a server that exposes Gmail, Google Drive, Calendar, Docs, Sheets, and over 10 other Google services to AI agents like Claude Code. The tool handles OAuth authentication and API access in a unified interface.

This MCP server targets developers and teams who want AI agents to read, search, and interact with their Google Workspace data. Instead of building custom API integrations, you configure the MCP server once and your agent gets structured access to all supported services.

How it saves time or tokens

Without this tool, connecting an AI agent to Google Workspace requires building OAuth flows, managing API credentials for each service, and writing custom tool definitions. Google Workspace MCP handles all of this with a single gws mcp command. You specify which services to expose, and the MCP server presents them as structured tools that agents can call directly.

How to use

1. Install the CLI globally: npm install -g @googleworkspace/cli.
2. Set up authentication with gws auth setup followed by gws auth login for one-time OAuth consent.
3. Start the MCP server with gws mcp -s drive,gmail,calendar to expose selected services.

Example

# Install the CLI
npm install -g @googleworkspace/cli

# One-time auth setup
gws auth setup
gws auth login

# Start MCP server with selected services
gws mcp -s drive,gmail,calendar

{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }
  }
}

Related on TokRepo

• MCP Integrations — MCP server integrations for AI agent workflows
• Coding AI Tools — AI-powered development tools

Common pitfalls

• OAuth scopes are broad by default. Limit the services you expose with the -s flag to only what your workflow needs. Avoid granting Gmail access if you only need Drive.
• The MCP server runs locally and requires an active OAuth session. Tokens expire and may need re-authentication periodically.
• Some Google Workspace APIs have rate limits. Heavy automation against Gmail or Drive may trigger quota errors. Check Google API console for your usage limits.