Quick Start Guide

Get started with Google Workspace MCP in 5 simple steps. From installation to verification.

1

Installation

Install the Google Workspace MCP server using uvx for instant setup.

# Install with all Google Workspace tools
uvx workspace-mcp

# Or install with specific tools only
uvx workspace-mcp --tools gmail drive calendar

Requires Python 3.11+ and uvx. You can install uvx from: https://github.com/astral-sh/uv

2

Authentication Setup

Configure OAuth 2.0 credentials for Google Workspace API access.

# Set OAuth credentials via environment variables (recommended)
export GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
Google Cloud Console →

Create OAuth 2.0 credentials in Google Cloud Console. Enable required APIs: Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Chat.

3

Server Configuration

Configure environment and start the MCP server.

# Allow HTTP for localhost OAuth callbacks (development only)
export OAUTHLIB_INSECURE_TRANSPORT=1

# Start the server (stdio mode for MCP clients)
uvx workspace-mcp

# Or start in HTTP mode for debugging
uvx workspace-mcp --transport streamable-http
4

Client Connection

Connect Claude Desktop to your MCP server.

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

Add this configuration to your Claude Desktop config file (claude_desktop_config.json).

5

Verification

Test your setup and verify all tools are working correctly.

  • Restart Claude Desktop to load the new MCP server
  • Test basic functionality like listing Gmail messages
  • Verify OAuth authentication flow completes successfully
  • Check that all required Google Workspace tools are available