First-party app
Google Workspace Admin

Google Workspace Admin

Manage Google Workspace users, groups and organizational units via the Admin SDK Directory API.

stable Security & IdentityProductivity

About

Google Workspace Admin ships in the w6w first-party pack. It declares 18 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.google-admin
Version
0.2.0
Author
w6w
Licence
MIT
Categories
Security & Identity · Productivity

Overview

Google Workspace Admin provisions and manages a Workspace domain’s directory from a workflow — creating, updating and deleting users; creating, updating and deleting groups and their memberships; and organizing users into organizational units.

Every operation requires either a Google Workspace super admin’s OAuth consent, or a service account authorized for Domain-Wide Delegation and impersonating an admin user — the Admin SDK Directory API has no lower-privilege mode. Group membership is managed as a first-class concern: members can be added, removed and listed independently of editing the group itself, which matters for workflows that sync membership from an external source of truth (an HR system, a ticket) rather than managing groups by hand.

A fit for automating employee onboarding/offboarding (create the account, add it to the right groups, place it in the right org unit) or keeping group rosters in sync with an external roster.

Build with Google Workspace Admin

Three routes to the same 18 actions. The Workflow tab is generated from Google Workspace Admin's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Delete Group

group-delete

Permanently delete a group.

Get Group

group-get

Retrieve a group by email address or unique ID.

Create Group

group-insert

Create a new group in the domain.

List Groups

group-list

List groups in the domain (one page).

Update Group

group-update

Patch a group's fields. Only the fields supplied are changed.

Remove Group Member

member-delete

Remove a member from a group.

Add Group Member

member-insert

Add a user (or another group) as a member of a group.

List Group Members

member-list

List the members of a group (one page).

Delete Org Unit

orgunit-delete

Permanently delete an organizational unit. It must have no child org units.

Get Org Unit

orgunit-get

Retrieve one organizational unit by path or unique ID.

Create Org Unit

orgunit-insert

Create a new organizational unit under a parent path.

List Org Units

orgunit-list

List organizational units under a path.

Update Org Unit

orgunit-update

Patch an organizational unit's fields. Only the fields supplied are changed.

Delete User

user-delete

Permanently delete a user account.

Get User

user-get

Retrieve a user by email address, alias, or unique ID.

Create User

user-insert

Provision a new user in the domain.

List Users

user-list

List users in the domain (one page). Requires a Workspace admin credential.

Update User

user-update

Patch a user's fields. Only the fields supplied are changed.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Google Workspace Admin's real ids.

{
  "manifestVersion": "2",
  "name": "google-admin-example",
  "steps": [
    {
      "id": "group-get",
      "uses": {
        "app": "io.w6w.google-admin",
        "action": "group-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "groupKey": "<groupKey>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Group

    read
    group-get
  • Create Group

    perform
    group-insert
  • List Groups

    search
    group-list
  • Update Group

    perform
    group-update
  • Add Group Member

    perform
    member-insert

+13 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Google Workspace Admin, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Google Workspace Admin. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "group-get",
  payload: {
    groupKey: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action group-get --payload '{"groupKey":"<value>"}'

Give an AI agent Google Workspace Admin — without giving it Google Workspace Admin's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.google-admin#group-get",
    "input": {
      "groupKey": "<groupKey>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Google Workspace Admin connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Google Workspace Admin's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Google Workspace Admin itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Google Workspace Admin declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Google Admin Console platform status

Open incidents for Admin Console (which the Directory API rides on) on the Google Workspace Status Dashboard. Unauthenticated and unsigned.

quota

API quota headroom