Skip to main content
Glama

GAM MCP Server

by dbarks

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.
  • Node.js: v18 or newer

Installation

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

Running the Server

GAM_PATH=/path/to/gam node dist/index.js
  • Or use the default gam in your PATH.

Claude Desktop Configuration

Add to your 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" } } } }

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 OUs
  • gam_move_user_orgunit: Move user between OUs

Domain Management

  • gam_get_domain_info: Get domain info

Example MCP Tool Calls

List users:

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

Get user:

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

Create group:

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

Troubleshooting

  • GAM not found: Set GAM_PATH or add gam 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

-
security - not tested
F
license - not found
-
quality - not tested

Enables Google Workspace administration through the GAM CLI, allowing Claude to manage users, groups, and organizational units via natural language.

  1. Prerequisites
    1. Installation
      1. Running the Server
        1. Claude Desktop Configuration
          1. Available Tools
            1. User Management
            2. Group Management
            3. Organizational Units
            4. Domain Management
          2. Example MCP Tool Calls
            1. Troubleshooting
              1. Security Considerations
                1. Extending

                  Related MCP Servers

                  • -
                    security
                    A
                    license
                    -
                    quality
                    Server 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,632
                    414
                    JavaScript
                    MIT License
                    • Linux
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    Provides 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 -
                    73
                    TypeScript
                    MIT License
                    • Linux
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An 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 -
                    6
                    Python
                  • -
                    security
                    F
                    license
                    -
                    quality
                    Enables 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 -
                    8
                    Python
                    • Apple

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/dbarks/mcp-gam'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server