Google Admin Mcp
What is Google Admin Mcp
google-admin-mcp is a FastMCP server designed for managing Google Workspace users through the Admin Directory API, providing a streamlined way to handle user accounts.
Use cases
Use cases include onboarding new employees by creating user accounts, managing user access by suspending or unsuspending accounts, and retrieving user information for administrative purposes.
How to use
To use google-admin-mcp, clone the repository, build the Docker image, and run the server with a valid OAuth2 token. You can then utilize various tools to manage users, such as listing users, adding new users, and suspending accounts.
Key features
Key features include listing users in a domain, creating new users with secure random passwords, retrieving detailed user information, and suspending or unsuspending user accounts.
Where to use
google-admin-mcp is primarily used in organizations that utilize Google Workspace, particularly in IT departments or administrative roles that require user management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Google Admin Mcp
google-admin-mcp is a FastMCP server designed for managing Google Workspace users through the Admin Directory API, providing a streamlined way to handle user accounts.
Use cases
Use cases include onboarding new employees by creating user accounts, managing user access by suspending or unsuspending accounts, and retrieving user information for administrative purposes.
How to use
To use google-admin-mcp, clone the repository, build the Docker image, and run the server with a valid OAuth2 token. You can then utilize various tools to manage users, such as listing users, adding new users, and suspending accounts.
Key features
Key features include listing users in a domain, creating new users with secure random passwords, retrieving detailed user information, and suspending or unsuspending user accounts.
Where to use
google-admin-mcp is primarily used in organizations that utilize Google Workspace, particularly in IT departments or administrative roles that require user management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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_JSONenvironment variable
Installation
- Clone the repository
- 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": "[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]"
}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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
