Provides tools for Google Workspace administration through GAM CLI, enabling management of users, groups, organizational units, and domains. Capabilities include listing, creating, and updating users; managing group memberships; moving users between organizational units; and retrieving domain information.
GAM MCP Server
Google Workspace administration via GAM CLI, ready for Claude Desktop and Model Context Protocol (MCP).
Prerequisites
- GAM: Install and authenticate GAM on your system.
- Run
gam version
to verify installation. - Run
gam oauth create
to authenticate with Google Workspace.
- Run
- Node.js: v18 or newer
Installation
Running the Server
- Or use the default
gam
in your PATH.
Claude Desktop Configuration
Add to your claude_desktop_config.json
:
Available Tools
User Management
gam_list_users
: List users (domain, query, maxResults)gam_get_user
: Get user details (email)gam_create_user
: Create user (email, firstName, lastName, password, orgUnit)gam_update_user
: Update user (email, updates)gam_suspend_user
/gam_unsuspend_user
: (email)gam_move_user_orgunit
: (email, orgUnitPath)
Group Management
gam_list_groups
: List groups (domain, maxResults)gam_get_group
: Get group details (groupEmail)gam_create_group
: Create group (groupEmail, groupName, description)gam_add_group_member
/gam_remove_group_member
: (groupEmail, memberEmail, role)
Organizational Units
gam_list_orgunits
: List OUsgam_move_user_orgunit
: Move user between OUs
Domain Management
gam_get_domain_info
: Get domain info
Example MCP Tool Calls
List users:
Get user:
Create group:
Troubleshooting
- GAM not found: Set
GAM_PATH
or addgam
to your PATH. - Authentication errors: Run
gam oauth create
. - Quota/rate limit: Wait and retry; see Google Admin API quotas.
- Parameter validation: All inputs are validated; see error messages for details.
Security Considerations
- Only whitelisted GAM commands are allowed.
- All parameters are validated and sanitized.
- No arbitrary command execution.
- Logs redact sensitive data.
- Rate limiting and error handling are built-in.
Extending
Add new tools in src/tools/
and export them in src/tools/index.ts
.
© 2024 GAM MCP Server Authors
This server cannot be installed
Enables Google Workspace administration through the GAM CLI, allowing Claude to manage users, groups, and organizational units via natural language.
Related MCP Servers
- -securityAlicense-qualityServer for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.Last updated -3,632414JavaScriptMIT License
- -securityAlicense-qualityProvides authenticated access to Google Workspace APIs with a focus on Gmail operations and planned Calendar support, featuring secure OAuth authentication and multi-account management with detailed error handling.Last updated -73TypeScriptMIT License
- -securityFlicense-qualityAn integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.Last updated -6Python
- -securityFlicense-qualityEnables managing Google Cloud Platform resources through natural language commands in Claude Desktop, supporting comprehensive operations across compute, storage, databases, networking, monitoring, and IAM without manual credential setup.Last updated -8Python