https://github.com/securityfortech/google-admin-mcp
https://github.com/securityfortech/google-admin-mcp
Last synced: 17 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/securityfortech/google-admin-mcp
- Owner: securityfortech
- License: mit
- Created: 2025-04-13T10:09:22.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2025-04-13T19:49:15.000Z (28 days ago)
- Last Synced: 2025-04-13T20:35:51.247Z (28 days ago)
- Language: JavaScript
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Google Admin MCP
README
# 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:
```bash
docker build -t google-admin-mcp .
```
## Running the Server
Run the container:
```bash
docker run -e GOOGLE_TOKEN_JSON="your_base64_encoded_token" google-admin-mcp
```
## Available Tools
### listUsers
Lists users in a domain.
```json
{
"domain": "yourdomain.com"
}
```
### addUser
Creates a new user with a secure random password.
```json
{
"primaryEmail": "[email protected]",
"firstName": "First",
"lastName": "Last"
}
```
### getUser
Gets detailed information about a specific user.
```json
{
"userKey": "[email protected]"
}
```
### suspendUser
Suspends a user account.
```json
{
"userKey": "[email protected]"
}
```
### unsuspendUser
Unsuspends a user account.
```json
{
"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