AdminRemix Workspace Plugin

A Claude Code plugin for Google Workspace administration through natural language.

Manage users, groups, email, Drive, calendars, and devices by just asking.

> Add john.doe@company.com to the engineering group

✓ Added john.doe@company.com to engineering@company.com

Features

• User Management: Create, update, suspend, delete users
• Group Management: Create groups, manage membership
• Email Settings: Vacation responders, forwarding, delegates
• Drive Operations: File permissions, ownership transfers
• Device Management: ChromeOS and mobile devices
• Reporting: User activity, admin audit logs, login reports

Installation

# Install the plugin
claude plugin install adminremix/workspace

# Configure Google Workspace access
claude workspace setup

Usage

Just talk to Claude naturally:

> List all suspended users
> Create a new user jane.smith@company.com
> Who is in the marketing group?
> Offboard john@company.com
> Show login failures from the past 24 hours

Setup Requirements

1. Google Workspace Admin Account - You need admin access to your domain
2. Google Cloud Project - For API access (free tier is sufficient)
3. Anthropic API Key - Used by Claude Code

The setup script will guide you through configuring OAuth credentials.

How It Works

This plugin consists of two parts:

1. Skill (skill/SKILL.md) - Instructions that teach Claude how to administer Google Workspace
2. MCP Server (mcp-server/) - TypeScript server that provides Google Admin API tools

When you ask Claude to perform an admin task, the skill guides Claude to use the appropriate MCP tools, which call the Google Workspace APIs.

Available Commands

Users

• list_users - List/search users
• get_user - Get user details
• create_user - Create new user
• update_user - Update user attributes
• suspend_user - Suspend account
• unsuspend_user - Reactivate account
• delete_user - Delete account

Groups

• list_groups - List all groups
• get_group - Get group details
• create_group - Create new group
• delete_group - Delete group
• list_members - List group members
• add_member - Add to group
• remove_member - Remove from group

Organizational Units

• list_org_units - List org structure
• create_org_unit - Create new OU

Gmail

• get_vacation - Get vacation settings
• set_vacation - Set vacation responder
• list_forwards - List forwarding addresses
• add_forward - Add forwarding
• list_delegates - List inbox delegates
• add_delegate - Add delegate

Drive

• list_files - List user's files
• transfer_ownership - Transfer file ownership
• list_shared_drives - List shared drives

Devices

• list_chromeos - List ChromeOS devices
• get_chromeos - Get device details
• update_chromeos - Update device
• disable_chromeos - Disable device

Reports

• user_report - User activity report
• admin_report - Admin audit log
• login_report - Login activity

Multi-Domain Support

To switch between domains (for MSPs managing multiple clients):

claude workspace setup

The setup script will detect existing configuration and offer to switch domains.

Audit Logging

All operations are logged to ~/.config/adminremix/audit.log in JSON format:

{"ts": "2026-01-31T10:30:00Z", "action": "add_member", "target": "john@company.com", "group": "marketing", "result": "success"}

Security

• Credentials are stored locally at ~/.config/adminremix/credentials.json
• File permissions are set to 600 (owner read/write only)
• OAuth tokens never leave your machine
• All operations require your explicit confirmation in Claude

Development

# Clone the repo
git clone https://github.com/admin-remix/workspace-skill

# Install MCP server dependencies
cd mcp-server
npm install

# Build
npm run build

# Run locally
npm start

License

Apache 2.0 - See LICENSE

Contributing

Contributions welcome! Please read our contributing guidelines first.

Support

• GitHub Issues
• AdminRemix Website

---

Built with ❤️ by AdminRemix