Google Admin MCP

🚀 Google Admin Console MCP Server

A FastMCP (Fast User Directory Service Protocol) server that manages Google Workspace users via the Admin Directory API.

🚀 Quick Start

This is a FastMCP server that enables the management of Google Workspace users through the Admin Directory API. It offers a range of functions for user management within Google Workspace.

✨ Features

• List users in a domain.
• Create new users with a secure random password.
• Retrieve detailed information about a specific user.
• Suspend and unsuspend user accounts.

📦 Installation

Prerequisites

• Docker
• A Google Workspace administrator account
• The Admin Directory API enabled
• A Base64-encoded OAuth2 token stored in the GOOGLE_TOKEN_JSON environment variable

Steps

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

docker build -t google-admin-mcp .

💻 Usage Examples

Running the Server

Run the container:

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

Available Tools

Basic Usage

listUsers

List users in a domain.

{
  "domain": "yourdomain.com"
}

addUser

Create a new user with a secure random password.

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

getUser

Retrieve detailed information about a specific user.

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

suspendUser

Suspend a user account.

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

unsuspendUser

Unsuspend a user account.

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

📚 Documentation

Security Considerations

• All newly created users are required to change their passwords upon first login.
• Password generation policy:
  • Minimum of 12 characters.
  • Include both uppercase and lowercase letters.
  • Include numbers.
  • Include special characters.
• The server requires a valid OAuth2 token with appropriate Admin Directory API permissions.

Error Handling

The server provides clear error messages, including:

• Authentication failure.
• Invalid parameters.
• API errors.
• Missing environment variables.

📄 License

This project is licensed under the MIT License.