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

• Node.js >= 20.0.0
• 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. Install dependencies:

npm install

Configuration

Set the required environment variable:

export GOOGLE_TOKEN_JSON="your_base64_encoded_token"

Available Tools

listUsers

Lists users in a domain.

{
  "domain": "yourdomain.com"
}

addUser

Creates a new user with a secure random password.

{
  "primaryEmail": "[email protected]",
  "firstName": "First",
  "lastName": "Last"
}

getUser

Gets detailed information about a specific user.

{
  "userKey": "[email protected]"
}

suspendUser

Suspends a user account.

{
  "userKey": "[email protected]"
}

unsuspendUser

Unsuspends a user account.

{
  "userKey": "[email protected]"
}

Running the Server

Start the server:

npm start

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