Skip to main content
FuseFuse
IntegrationsGoogle workspaceActions

List Google Workspace users

List users in the Workspace directory.

Agent markdown

users.list · Google Workspace · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • https://www.googleapis.com/auth/admin.directory.user.readonly

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
customerstringNominLength 1
querystringNo
page_sizeintegerNominimum 1; maximum 500
page_tokenstringNo

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
usersarray<object>Yes
users[]objectYesadditionalProperties false
users[].idstringYes
users[].primary_emailstringYes
users[].nameobjectNoadditionalProperties false
users[].name.given_namestringNo
users[].name.family_namestringNo
users[].name.full_namestringNo
users[].suspendedbooleanYes
users[].org_unit_pathstringNo
next_page_tokenstringNo

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "customer": {
      "type": "string",
      "minLength": 1
    },
    "query": {
      "type": "string"
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "page_token": {
      "type": "string"
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "primary_email": {
            "type": "string"
          },
          "name": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "given_name": {
                "type": "string"
              },
              "family_name": {
                "type": "string"
              },
              "full_name": {
                "type": "string"
              }
            }
          },
          "suspended": {
            "type": "boolean"
          },
          "org_unit_path": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "primary_email",
          "suspended"
        ]
      }
    },
    "next_page_token": {
      "type": "string"
    }
  },
  "required": [
    "users"
  ]
}