Skip to content
MCP server

Google Workspace MCP

Cross-client Google Workspace admin: 2SV gaps, license waste, sharing drift, safe…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.10
Listing updated
4 days ago

About Google Workspace MCP

Google Workspace MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Cross-client Google Workspace admin: 2SV gaps, license waste, sharing drift, safe offboarding.

Install

Run in a terminal

claude mcp add google-workspace-mcp --env GOOGLE_WORKSPACE_TOKEN='<GOOGLE_WORKSPACE_TOKEN>' --env ADMIN_ACCESS_TOKEN='<ADMIN_ACCESS_TOKEN>' --env GOOGLE_WORKSPACE_MCP_HTTP_TOKEN='<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb"
      ],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN": "<GOOGLE_WORKSPACE_TOKEN>",
        "ADMIN_ACCESS_TOKEN": "<ADMIN_ACCESS_TOKEN>",
        "GOOGLE_WORKSPACE_MCP_HTTP_TOKEN": "<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb"
      ],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN": "<GOOGLE_WORKSPACE_TOKEN>",
        "ADMIN_ACCESS_TOKEN": "<ADMIN_ACCESS_TOKEN>",
        "GOOGLE_WORKSPACE_MCP_HTTP_TOKEN": "<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-workspace-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb"
      ],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN": "<GOOGLE_WORKSPACE_TOKEN>",
        "ADMIN_ACCESS_TOKEN": "<ADMIN_ACCESS_TOKEN>",
        "GOOGLE_WORKSPACE_MCP_HTTP_TOKEN": "<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb"
      ],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN": "<GOOGLE_WORKSPACE_TOKEN>",
        "ADMIN_ACCESS_TOKEN": "<ADMIN_ACCESS_TOKEN>",
        "GOOGLE_WORKSPACE_MCP_HTTP_TOKEN": "<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb"
      ],
      "env": {
        "GOOGLE_WORKSPACE_TOKEN": "<GOOGLE_WORKSPACE_TOKEN>",
        "ADMIN_ACCESS_TOKEN": "<ADMIN_ACCESS_TOKEN>",
        "GOOGLE_WORKSPACE_MCP_HTTP_TOKEN": "<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_WORKSPACE_TENANTDefault client tenant (from google-workspace-cli tenants list) for tool calls that name no tenant, including sql, search and raw API calls. Set it when more than one tenant is registered: without it sql and search refuse to answer.
  • GOOGLE_WORKSPACE_MCP_READ_ONLYSet to exactly 1 to hide offboard, sync, export, tenants test, tenants remove, workflow archive, the raw API execute tool, and every tool that writes the local learning store (teach, teach-pattern, teach-lookup, teach-playbook, playbook amend, learnings confirm, learnings forget and learnings reject), so only reads reach Google (true or yes are ignored). Leave blank for the full tool set.
  • GOOGLE_WORKSPACE_NO_LOCAL_DATAOptional. Set to exactly 1 to keep no local copy of Google Workspace data: reads go to the API, the response cache is off, nothing new is written to the local store, and sync and workflow archive are refused. Leave blank to keep the local mirror.
  • GOOGLE_WORKSPACE_TOKENOptional single-organization OAuth access token with Admin SDK scopes, for use instead of registering client tenants. Leave blank once tenants are registered.
  • ADMIN_ACCESS_TOKENOptional alternate name for GOOGLE_WORKSPACE_TOKEN. Leave blank.
  • GOOGLE_WORKSPACE_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Not needed for the default local stdio transport.
  • GOOGLE_WORKSPACE_BASE_URLOverrides the https://admin.googleapis.com host, for testing against a mock server. Leave blank.
  • GOOGLE_WORKSPACE_USER_AGENTOverrides the User-Agent the CLI sends on Google requests. Leave blank.
  • PRINTING_PRESS_CLIENT_PROFILEHas no effect for this connector (not a Google Workspace tenant). Leave blank.

Pricing

Open source

Google Workspace MCP FAQ

Is Google Workspace MCP free?

Yes. Google Workspace MCP is open source, so you can use and self-host it for free.

How do I add Google Workspace MCP to Claude Code?

Run this command in your terminal: claude mcp add google-workspace-mcp --env GOOGLE_WORKSPACE_TOKEN='<GOOGLE_WORKSPACE_TOKEN>' --env ADMIN_ACCESS_TOKEN='<ADMIN_ACCESS_TOKEN>' --env GOOGLE_WORKSPACE_MCP_HTTP_TOKEN='<GOOGLE_WORKSPACE_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/google-workspace-v0.1.10/google-workspace-mcp.mcpb