A FastMCP server for managing Google Workspace users through the Admin Directory API.

• List users in a domain
• Create new users with secure random passwords
• Get detailed user information
• Suspend and unsuspend users

• Docker
• Google Workspace Admin account
• Google Admin Directory API enabled
• Base64 encoded OAuth2 token in GOOGLE_TOKEN_JSON environment variable

1. Clone the repository
2. Build the Docker image:

docker build -t google-admin-mcp .

Run the container:

docker run -e GOOGLE_TOKEN_JSON="your_base64_encoded_token" google-admin-mcp

Lists users in a domain.

{
  "domain": "yourdomain.com"
}

Creates a new user with a secure random password.

{
  "primaryEmail": "user@yourdomain.com",
  "firstName": "First",
  "lastName": "Last"
}

Gets detailed information about a specific user.

{
  "userKey": "user@yourdomain.com"
}

Suspends a user account.

{
  "userKey": "user@yourdomain.com"
}

Unsuspends a user account.

{
  "userKey": "user@yourdomain.com"
}

• All users created will be required to change their password on first login
• Passwords are generated securely with:
  • Minimum 12 characters
  • Uppercase and lowercase letters
  • Numbers
  • Special characters
• The server requires a valid OAuth2 token with appropriate Admin Directory API scopes

The server provides clear error messages for:

• Authentication failures
• Invalid parameters
• API errors
• Missing environment variables

MIT License