google-workspace-admin-mcp
Provides tools for administering a Google Workspace tenant through the admin APIs, covering directory users, groups, org units, devices, and tokens; audit and usage reports; Alert Center; Vault matters and holds; Cloud Search; Data Transfer; Enterprise License Manager; Groups Settings; and Calendar Resources. It is read-only by default and excludes user-content APIs such as Gmail, Drive, Calendar, and YouTube.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
google-workspace-admin-mcp
An MCP server for the Google Workspace admin plane: the APIs that manage a tenant, not the ones that read a user's mail.
Status: early development. The repository is scaffolded and specified; no tools are implemented yet. Track progress in the issues.
Why
Google now ships hosted MCP servers for user surfaces — Gmail, Drive, Calendar. Nothing covers the admin surfaces where an administrator actually spends their day: who exists, what happened, what is licensed, what must be held or transferred. The community servers that touch admin APIs are shallow, stale, or built around key files.
Admin work is also sequence work. "User reports a phishing email" is not one API call, it is: find the user, read their recent logins, list their OAuth grants, list their app passwords and devices, revoke sessions, then decide whether to suspend. Tools alone are not the product; the sequence is. MCP makes sequences cheap, which is why this belongs here rather than in a dashboard.
Related MCP server: Google Workspace MCP Server
What this is not
This server cannot read your users' mail. That is enforced in code, not just stated in a README:
No service accounts. No key files, no JWT signing, no key rotation.
No domain-wide delegation.
No impersonation: there is no
asparameter anywhere, and no credential type that could express one.No user-content APIs: Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat, Meet, Keep, Tasks, Forms, YouTube, Classroom, Sites and Apps Script are out of scope, permanently.
The supported paths for the things people use impersonation for are the audited ones: Vault for legal holds and eDiscovery, Data Transfer for offboarding, Reports and Alert Center for investigation. That is the whole design.
It is also not a GAM replacement. GAM is a scripting language with a decade of edge cases; this is a small set of typed tools built to be driven by a model without guessing.
Scope
Surface | What it covers |
Directory | users, aliases, groups, members, org units, roles, devices, tokens, domains |
Reports | audit activities, customer and entity usage reports |
Alert Center | alerts, feedback, delete/undelete |
Vault | matters, holds, held accounts, exports, saved queries, operations |
Cloud Search | query, suggest, sources |
Data Transfer | transfers for offboarding |
Enterprise License Manager | assign, revoke, list |
Groups Settings | group access and moderation settings |
Calendar Resources | buildings, rooms, features |
Passthrough | one allowlisted raw call per enabled API, for what curated tools miss |
Authentication
One credential: an admin user OAuth client you create in your own Google Cloud project, with the application type set to Internal. The administrator signs in once; the refresh token is stored locally with owner-only permissions.
No service account, no DWD grant, no super-admin security settings to change.
The Internal app type gives long-lived refresh tokens without verification. A client left in Testing publishing status expires refresh tokens after seven days — the setup docs call this out because it silently breaks an unattended admin tool.
Scopes are admin-only. Nothing in the requested scope list grants mailbox or file content of another user.
Safety model
Read-only by default. Mutating tools are absent unless writes are enabled.
Confirmation on destructive operations (suspend, delete, revoke, transfer, hold removal, export creation) — the caller must pass an explicit confirm flag that the tool documents.
Append-only local audit log of every tool call: timestamp, tool, arguments (secrets redacted), outcome.
Edition-aware errors. Vault and Cloud Search require Enterprise or Education; Data Transfer and Alert Center are broadly but not universally available. Those tools say so instead of surfacing a bare 403.
Install
Not published yet. The intended flow:
npx google-workspace-admin-mcpwith credentials configured through environment variables documented in
docs/SETUP.md once that file exists.
Development
npm install
npm run check # typecheck + lint + testsSpecs live in openspec/changes/workspace-admin-mcp/. Each capability spec is
linked from its tracking issue. OpenSpec is used for planning only; tests are the
enforcement mechanism.
License
MIT. Part of the Single Barrel Labs MCP family — google-services-mcp covers the
user plane, this covers the admin plane.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
Cloud cost, inventory and governance on AWS/Azure/GCP. Read-only by default, optional scoped writes
Permissioned access to Gmail, Drive and Calendar via the user's own Google account
Work, docs, CRM, calendar, chat and hiring for small teams. OAuth 2.1 with scoped, audited access.
Related MCP Servers
- AlicenseBqualityBmaintenanceProduction-grade MCP server for the Google Tag Manager API v2 with read-only GA4 (Admin + Data API) tooling. 107 tools covering the full GTM surface, including server-side containers. Ships read-only: writes, publishes, and deletes are each gated behind separate opt-in flags, every mutation requires per-call confirmation, and a dry-run mode simulates changes. Includes container audits203663 npm3MIT
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Google Workspace APIs (Gmail, Drive, Sheets, Docs, Slides, Calendar, Admin Directory) using a service account with domain-wide delegation.528 npmMIT
- FlicenseAqualityDmaintenanceEnables Google Workspace administration (Directory, Gmail, Drive, Sheets) via MCP using Domain-Wide Delegation for secure, schema-validated tool operations.132-
- AlicenseAqualityCmaintenanceEnables comprehensive Google Apps Script project lifecycle management (creation, content, versions, deployments, execution, metrics) and controlled access to Google Workspace APIs (Sheets, Docs, Drive, Gmail, Calendar, Tasks, Forms, Slides) with automatic PKCE OAuth and explicit confirmations for destructive actions.23MIT