Google Workspace MCP server | MCP Directory
From the publisher
Documentation 🔧 Google Workspace MCP Server
🇮🇹 Italiano | 🇬🇧 English
Italiano
Server MCP (Model Context Protocol) per gestire Google Workspace tramite Claude AI e altri assistenti compatibili. Permette di amministrare utenti, gruppi, alias e unità organizzative tramite conversazione naturale.
Google Workspace Admin via MCP. Manage users, groups, aliases, org units.
The MCP directory of official registry servers for Cursor, Claude, and Codex. Search, open a page, copy the install JSON.
Newsletter
Occasional updates. Confirm by email.
Browse
Guides and advertise
Directories
GOOGLE_SERVICE_ACCOUNT_FILE, GOOGLE_ADMIN_EMAIL, GOOGLE_CUSTOMER_ID
✨ Funzionalità
📋 Prerequisiti
Python 3.10+
Account Google Workspace con accesso admin
Progetto Google Cloud con Admin SDK API abilitata
Claude Desktop o altro client MCP
🚀 Installazione pip install google-workspace-mcp
git clone https://github.com/aringad/google-workspace-mcp.git
cd google-workspace-mcp
pip install -r requirements.txt
🔑 Configurazione Google Cloud
1. Crea progetto e abilita API
Vai su console.cloud.google.com
Crea un nuovo progetto (o usa quello esistente)
Vai su API e servizi → Libreria
Cerca e abilita: Admin SDK API
2. Crea Service Account
Vai su API e servizi → Credenziali
Crea credenziali → Account di servizio
Dai un nome (es. mcp-workspace-admin)
Vai nel Service Account → Chiavi → Aggiungi chiave → JSON
Scarica il file JSON (queste sono le tue credenziali)
Annota il Client ID (numero lungo nei dettagli del Service Account)
⚠️ Non serve assegnare ruoli IAM al Service Account. I permessi vengono dalla delega domain-wide.
3. Delega Domain-Wide
Vai su admin.google.com
Sicurezza → Accesso e controllo dati → Controlli API → Gestisci delega a livello di dominio
Clicca Aggiungi nuovo
Inserisci il Client ID del Service Account
Come ambiti OAuth, inserisci:
https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/admin.directory.orgunit,https://www.googleapis.com/auth/admin.directory.user.alias
⚙️ Variabili d'ambiente
🔌 Configurazione Claude Desktop Aggiungi al file di configurazione:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"google_workspace": {
"command": "/percorso/completo/google-workspace-mcp/venv/bin/python",
"args": ["/percorso/completo/google-workspace-mcp/server.py"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_FILE": "/percorso/completo/credentials.json",
"GOOGLE_ADMIN_EMAIL": "[email protected] "
}
}
}
}
Chiudi completamente Claude Desktop (Cmd+Q su Mac) e riaprilo.
🏢 Configurazione multi-cliente Puoi gestire più domini aggiungendo istanze separate:
{
"mcpServers": {
"gw_cliente_alfa": {
"command": "/percorso/venv/bin/python",
"args": ["server.py"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_FILE": "/percorso/credentials-alfa.json",
"GOOGLE_ADMIN_EMAIL": "[email protected] "
}
},
"gw_cliente_beta": {
"command": "/percorso/venv/bin/python",
"args": ["server.py"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_FILE": "/percorso/credentials-beta.json",
"GOOGLE_ADMIN_EMAIL": "[email protected] "
}
}
}
}
💬 Esempi d'uso Una volta configurato, puoi dire a Claude:
Puoi anche copiare direttamente l'email del cliente con la richiesta e Claude interpreterà automaticamente le operazioni da eseguire.
🔒 Sicurezza
Le credenziali del Service Account non vanno mai committate nel repository
Le password temporanee generate sono di 16 caratteri con lettere, numeri e simboli
Le operazioni distruttive (eliminazione) richiedono conferma esplicita
Il Service Account opera con i soli permessi strettamente necessari
Nessun dato viene memorizzato dal server MCP
🧪 Test # Verifica che il server parta
python server.py --help
# Test con MCP Inspector
npx @modelcontextprotocol/inspector python server.py
English MCP (Model Context Protocol) Server to integrate Google Workspace Admin with Claude AI and other compatible assistants. Manage users, groups, aliases and organizational units through natural conversation.
✨ Features
📋 Prerequisites
Python 3.10+
Google Workspace account with admin access
Google Cloud project with Admin SDK API enabled
Claude Desktop or another MCP client
🚀 Installation pip install google-workspace-mcp
git clone https://github.com/aringad/google-workspace-mcp.git
cd google-workspace-mcp
pip install -r requirements.txt
🔑 Google Cloud Setup
1. Create project and enable API
Go to console.cloud.google.com
Create a new project (or use existing one)
Go to APIs & Services → Library
Search and enable: Admin SDK API
2. Create Service Account
Go to APIs & Services → Credentials
Create Credentials → Service Account
Name it (e.g., mcp-workspace-admin)
Go to the Service Account → Keys → Add Key → JSON
Download the JSON file (these are your credentials)
Note the Client ID (long number in Service Account details)
⚠️ No IAM roles needed on the Service Account. Permissions come from domain-wide delegation.
3. Domain-Wide Delegation
Go to admin.google.com
Security → Access and data control → API controls → Manage Domain Wide Delegation
Click Add new
Enter the Service Account Client ID
For OAuth scopes, enter:
https://www.googleapis.com/auth/admin.directory.user,https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/admin.directory.orgunit,https://www.googleapis.com/auth/admin.directory.user.alias
⚙️ Environment Variables
🔌 Claude Desktop Configuration
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"google_workspace": {
"command": "/full/path/to/google-workspace-mcp/venv/bin/python",
"args": ["/full/path/to/google-workspace-mcp/server.py"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_FILE": "/full/path/to/credentials.json",
"GOOGLE_ADMIN_EMAIL": "[email protected] "
}
}
}
}
Fully quit Claude Desktop (Cmd+Q on Mac) and reopen it.
💬 Usage Examples Once configured, you can tell Claude:
You can also paste client emails with requests directly — Claude will automatically interpret the operations to perform.
🔒 Security
Service Account credentials must never be committed to the repository
Temporary passwords are 16 characters with letters, numbers, and symbols
Destructive operations (deletion) require explicit confirmation
The Service Account operates with minimum necessary permissions
No data is stored by the MCP server
🧪 Testing # Verify server starts
python server.py --help
# Test with MCP Inspector
npx @modelcontextprotocol/inspector python server.py
📄 License MIT License — See LICENSE for details.
👨💻 Author
Public Apis A collective list of free APIs Pipeworx Gateway Live data for AI agents. 250+ data sources, 900+ tools. Ask questions in plain English with ask_pipeworx — trade flows, SEC filings, drug safety, housing data, and more. No API keys needed. Rea Reverse engineer anything with agents, from app behavior down to native binaries. Coding Interview University A complete computer science study plan to become a software engineer. Skills Skills for Real Engineers. Straight from my .agents directory. Hermes Agent The agent that grows with you SparkForge Access a versatile collection of tools for media generation, web scraping, and cryptocurrency research. Convert between data formats, summarize long documents, and extract text from images or PDFs wit N8n Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations. Awesome Go A curated list of awesome Go frameworks, libraries and software Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Agency Agents A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, a The Art Of Command Line Master the command line, in one page
No tool list yet. Remote servers get one after the first health check.
How do I install Google Workspace? Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Google Workspace need an API key? The publisher lists these environment variables: GOOGLE_SERVICE_ACCOUNT_FILE, GOOGLE_ADMIN_EMAIL, GOOGLE_CUSTOMER_ID.
What transport does Google Workspace use? Google Workspace runs locally over stdio.
When was Google Workspace last checked? Last checked 2026-11-09. Google Workspace Admin via MCP. Manage users, groups, aliases, org units.