Google Admin MCP Server

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

Features

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

Prerequisites

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

Installation

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

docker build -t google-admin-mcp .

Running the Server

Run the container:

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

Available Tools

listUsers

Lists users in a domain.

{
  "domain": "yourdomain.com"
}

addUser

Creates a new user with a secure random password.

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

getUser

Gets detailed information about a specific user.

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

suspendUser

Suspends a user account.

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

unsuspendUser

Unsuspends a user account.

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

Security Notes

• 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

Error Handling

The server provides clear error messages for:

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

License

MIT License