GAM MCP Server

Administració de Google Workspace via GAM CLI, preparada per a Claude Desktop i el Protocol de Context de Model (MCP).

Requisits

• GAM: Installeu i autentiqueu GAM al vostre sistema.
  • Executeu gam version per verificar la instal·lació.
  • Executeu gam oauth create per autenticar-vos amb Google Workspace.
• Node.js: v18 o superior

Instal·lació

# Clone or copy this repo
cd gam-mcp-server
npm install
npm run build

Executar el servidor

GAM_PATH=/path/to/gam node dist/index.js

• O useu el gam per defecte al vostre PATH.

Configuració de Claude Desktop

Afegiu a la vostra claude_desktop_config.json:

{
  "mcpServers": {
    "gam-workspace": {
      "command": "node",
      "args": ["/absolute/path/to/gam-mcp-server/dist/index.js"],
      "env": {
        "GAM_PATH": "/path/to/gam"
      }
    }
  }
}

Eines disponibles

Gestió d'usuaris

• gam_list_users: Llista usuaris (domain, query, maxResults)
• gam_get_user: Obtenir detalls d'usuari (email)
• gam_create_user: Crear usuari (email, firstName, lastName, password, orgUnit)
• gam_update_user: Actualitzar usuari (email, updates)
• gam_suspend_user / gam_unsuspend_user: (email)
• gam_move_user_orgunit: (email, orgUnitPath)

Gestió de grups

• gam_list_groups: Llista grups (domain, maxResults)
• gam_get_group: Obtenir detalls de grup (groupEmail)
• gam_create_group: Crear grup (groupEmail, groupName, description)
• gam_add_group_member / gam_remove_group_member: (groupEmail, memberEmail, role)

Unitats organitzatives

• gam_list_orgunits: Llista OUs
• gam_move_user_orgunit: Moure usuari entre OUs

Gestió de domini

• gam_get_domain_info: Obtenir informació del domini

Exemple d'crides a eines MCP

Llista usuaris:

{
  "method": "tools/call",
  "params": {
    "name": "gam_list_users",
    "arguments": { "maxResults": 10 }
  }
}

Obtenir usuari:

{
  "method": "tools/call",
  "params": {
    "name": "gam_get_user",
    "arguments": { "email": "user@example.com" }
  }
}

Crear grup:

{
  "method": "tools/call",
  "params": {
    "name": "gam_create_group",
    "arguments": { "groupEmail": "team@example.com", "groupName": "Team" }
  }
}

Resolució de problemes

• GAM no trobat: Establiu GAM_PATH o afegiu gam al vostre PATH.
• Errors d'autenticació: Executeu gam oauth create.
• Quota/límit de taxa: Espereu i torneu a intentar; consulteu les quotas de l'API d'Admin de Google.
• Validació de paràmetres: Tots els inputs es validen; consulteu els missatges d'error per a més detalls.