Google Admin MCP
A Model Context Protocol (MCP) server enabling interaction with Google Admin APIs.
What can you do with Google Admin MCP?
- List users in a domain
- Create new users with secure random passwords
- Get detailed user information
- Suspend and unsuspend users
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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:
bash 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
Frequently asked questions
What is Google Admin MCP?
A Model Context Protocol (MCP) server enabling interaction with Google Admin APIs.
How do I install Google Admin MCP?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is Google Admin MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Google Admin MCP?
It is published by securityfortech. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.