MCP ExplorerExplorer

Google Admin Mcp

@securityfortechon a month ago
1 MIT
FreeCommunity
AI Systems
A FastMCP server for managing Google Workspace users through the Admin Directory API.

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.

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_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": "[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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers