
Google Workspace MCP
Cross-client Google Workspace admin: 2SV gaps, license waste, sharing drift, safe…
- 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.mcpbAdd 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