Google Admin SDK Directory API

naftiko: 1.0.0-alpha2
info:
  label: Google Admin SDK Directory API
  description: The Admin SDK Directory API enables management of users, groups, devices, organizational units, roles, domains,
    and other directory resources in a Google Workspace domain.
  tags:
  - Google
  - Admin
  - Sdk
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-admin-sdk
    baseUri: https://admin.googleapis.com
    description: Google Admin SDK Directory API HTTP API.
    resources:
    - name: admin-directory-v1-users
      path: /admin/directory/v1/users
      operations:
      - name: listusers
        method: GET
        description: Google Admin SDK List users
        inputParameters:
        - name: domain
          in: query
          type: string
        - name: customer
          in: query
          type: string
        - name: maxResults
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        - name: query
          in: query
          type: string
        - name: orderBy
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createuser
        method: POST
        description: Google Admin SDK Create user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-users-userkey
      path: /admin/directory/v1/users/{userKey}
      operations:
      - name: getuser
        method: GET
        description: Google Admin SDK Get user
        inputParameters:
        - name: userKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateuser
        method: PUT
        description: Google Admin SDK Update user
        inputParameters:
        - name: userKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchuser
        method: PATCH
        description: Google Admin SDK Patch user
        inputParameters:
        - name: userKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteuser
        method: DELETE
        description: Google Admin SDK Delete user
        inputParameters:
        - name: userKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-users-userkey-makeadmin
      path: /admin/directory/v1/users/{userKey}/makeAdmin
      operations:
      - name: makeuseradmin
        method: POST
        description: Google Admin SDK Make user admin
        inputParameters:
        - name: userKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-groups
      path: /admin/directory/v1/groups
      operations:
      - name: listgroups
        method: GET
        description: Google Admin SDK List groups
        inputParameters:
        - name: domain
          in: query
          type: string
        - name: customer
          in: query
          type: string
        - name: maxResults
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        - name: userKey
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: creategroup
        method: POST
        description: Google Admin SDK Create group
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-groups-groupkey
      path: /admin/directory/v1/groups/{groupKey}
      operations:
      - name: getgroup
        method: GET
        description: Google Admin SDK Get group
        inputParameters:
        - name: groupKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updategroup
        method: PUT
        description: Google Admin SDK Update group
        inputParameters:
        - name: groupKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletegroup
        method: DELETE
        description: Google Admin SDK Delete group
        inputParameters:
        - name: groupKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-groups-groupkey-members
      path: /admin/directory/v1/groups/{groupKey}/members
      operations:
      - name: listmembers
        method: GET
        description: Google Admin SDK List group members
        inputParameters:
        - name: groupKey
          in: path
          type: string
          required: true
        - name: maxResults
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: addmember
        method: POST
        description: Google Admin SDK Add group member
        inputParameters:
        - name: groupKey
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-customer-customerid-orgunits
      path: /admin/directory/v1/customer/{customerId}/orgunits
      operations:
      - name: listorgunits
        method: GET
        description: Google Admin SDK List organizational units
        inputParameters:
        - name: customerId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createorgunit
        method: POST
        description: Google Admin SDK Create organizational unit
        inputParameters:
        - name: customerId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-customer-customerid-devices-c
      path: /admin/directory/v1/customer/{customerId}/devices/chromeos
      operations:
      - name: listchromeosdevices
        method: GET
        description: Google Admin SDK List Chrome OS devices
        inputParameters:
        - name: customerId
          in: path
          type: string
          required: true
        - name: maxResults
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-customer-customerid-devices-m
      path: /admin/directory/v1/customer/{customerId}/devices/mobile
      operations:
      - name: listmobiledevices
        method: GET
        description: Google Admin SDK List mobile devices
        inputParameters:
        - name: customerId
          in: path
          type: string
          required: true
        - name: maxResults
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-customer-customerid-roles
      path: /admin/directory/v1/customer/{customerId}/roles
      operations:
      - name: listroles
        method: GET
        description: Google Admin SDK List roles
        inputParameters:
        - name: customerId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-directory-v1-customer-customer-domains
      path: /admin/directory/v1/customer/{customer}/domains
      operations:
      - name: listdomains
        method: GET
        description: Google Admin SDK List domains
        inputParameters:
        - name: customer
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-admin-sdk-rest
    description: REST adapter for Google Admin SDK Directory API.
    resources:
    - path: /admin/directory/v1/users
      name: listusers
      operations:
      - method: GET
        name: listusers
        description: Google Admin SDK List users
        call: google-admin-sdk.listusers
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users
      name: createuser
      operations:
      - method: POST
        name: createuser
        description: Google Admin SDK Create user
        call: google-admin-sdk.createuser
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users/{userKey}
      name: getuser
      operations:
      - method: GET
        name: getuser
        description: Google Admin SDK Get user
        call: google-admin-sdk.getuser
        with:
          userKey: rest.userKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users/{userKey}
      name: updateuser
      operations:
      - method: PUT
        name: updateuser
        description: Google Admin SDK Update user
        call: google-admin-sdk.updateuser
        with:
          userKey: rest.userKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users/{userKey}
      name: patchuser
      operations:
      - method: PATCH
        name: patchuser
        description: Google Admin SDK Patch user
        call: google-admin-sdk.patchuser
        with:
          userKey: rest.userKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users/{userKey}
      name: deleteuser
      operations:
      - method: DELETE
        name: deleteuser
        description: Google Admin SDK Delete user
        call: google-admin-sdk.deleteuser
        with:
          userKey: rest.userKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/users/{userKey}/makeAdmin
      name: makeuseradmin
      operations:
      - method: POST
        name: makeuseradmin
        description: Google Admin SDK Make user admin
        call: google-admin-sdk.makeuseradmin
        with:
          userKey: rest.userKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups
      name: listgroups
      operations:
      - method: GET
        name: listgroups
        description: Google Admin SDK List groups
        call: google-admin-sdk.listgroups
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups
      name: creategroup
      operations:
      - method: POST
        name: creategroup
        description: Google Admin SDK Create group
        call: google-admin-sdk.creategroup
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups/{groupKey}
      name: getgroup
      operations:
      - method: GET
        name: getgroup
        description: Google Admin SDK Get group
        call: google-admin-sdk.getgroup
        with:
          groupKey: rest.groupKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups/{groupKey}
      name: updategroup
      operations:
      - method: PUT
        name: updategroup
        description: Google Admin SDK Update group
        call: google-admin-sdk.updategroup
        with:
          groupKey: rest.groupKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups/{groupKey}
      name: deletegroup
      operations:
      - method: DELETE
        name: deletegroup
        description: Google Admin SDK Delete group
        call: google-admin-sdk.deletegroup
        with:
          groupKey: rest.groupKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups/{groupKey}/members
      name: listmembers
      operations:
      - method: GET
        name: listmembers
        description: Google Admin SDK List group members
        call: google-admin-sdk.listmembers
        with:
          groupKey: rest.groupKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/groups/{groupKey}/members
      name: addmember
      operations:
      - method: POST
        name: addmember
        description: Google Admin SDK Add group member
        call: google-admin-sdk.addmember
        with:
          groupKey: rest.groupKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customerId}/orgunits
      name: listorgunits
      operations:
      - method: GET
        name: listorgunits
        description: Google Admin SDK List organizational units
        call: google-admin-sdk.listorgunits
        with:
          customerId: rest.customerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customerId}/orgunits
      name: createorgunit
      operations:
      - method: POST
        name: createorgunit
        description: Google Admin SDK Create organizational unit
        call: google-admin-sdk.createorgunit
        with:
          customerId: rest.customerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customerId}/devices/chromeos
      name: listchromeosdevices
      operations:
      - method: GET
        name: listchromeosdevices
        description: Google Admin SDK List Chrome OS devices
        call: google-admin-sdk.listchromeosdevices
        with:
          customerId: rest.customerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customerId}/devices/mobile
      name: listmobiledevices
      operations:
      - method: GET
        name: listmobiledevices
        description: Google Admin SDK List mobile devices
        call: google-admin-sdk.listmobiledevices
        with:
          customerId: rest.customerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customerId}/roles
      name: listroles
      operations:
      - method: GET
        name: listroles
        description: Google Admin SDK List roles
        call: google-admin-sdk.listroles
        with:
          customerId: rest.customerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/directory/v1/customer/{customer}/domains
      name: listdomains
      operations:
      - method: GET
        name: listdomains
        description: Google Admin SDK List domains
        call: google-admin-sdk.listdomains
        with:
          customer: rest.customer
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-admin-sdk-mcp
    transport: http
    description: MCP adapter for Google Admin SDK Directory API for AI agent use.
    tools:
    - name: listusers
      description: Google Admin SDK List users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listusers
      with:
        domain: tools.domain
        customer: tools.customer
        maxResults: tools.maxResults
        pageToken: tools.pageToken
        query: tools.query
        orderBy: tools.orderBy
      inputParameters:
      - name: domain
        type: string
        description: domain
      - name: customer
        type: string
        description: customer
      - name: maxResults
        type: integer
        description: maxResults
      - name: pageToken
        type: string
        description: pageToken
      - name: query
        type: string
        description: query
      - name: orderBy
        type: string
        description: orderBy
      outputParameters:
      - type: object
        mapping: $.
    - name: createuser
      description: Google Admin SDK Create user
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.createuser
      outputParameters:
      - type: object
        mapping: $.
    - name: getuser
      description: Google Admin SDK Get user
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.getuser
      with:
        userKey: tools.userKey
      inputParameters:
      - name: userKey
        type: string
        description: userKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updateuser
      description: Google Admin SDK Update user
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: google-admin-sdk.updateuser
      with:
        userKey: tools.userKey
      inputParameters:
      - name: userKey
        type: string
        description: userKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: patchuser
      description: Google Admin SDK Patch user
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.patchuser
      with:
        userKey: tools.userKey
      inputParameters:
      - name: userKey
        type: string
        description: userKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteuser
      description: Google Admin SDK Delete user
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: google-admin-sdk.deleteuser
      with:
        userKey: tools.userKey
      inputParameters:
      - name: userKey
        type: string
        description: userKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: makeuseradmin
      description: Google Admin SDK Make user admin
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.makeuseradmin
      with:
        userKey: tools.userKey
      inputParameters:
      - name: userKey
        type: string
        description: userKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listgroups
      description: Google Admin SDK List groups
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listgroups
      with:
        domain: tools.domain
        customer: tools.customer
        maxResults: tools.maxResults
        pageToken: tools.pageToken
        userKey: tools.userKey
      inputParameters:
      - name: domain
        type: string
        description: domain
      - name: customer
        type: string
        description: customer
      - name: maxResults
        type: integer
        description: maxResults
      - name: pageToken
        type: string
        description: pageToken
      - name: userKey
        type: string
        description: userKey
      outputParameters:
      - type: object
        mapping: $.
    - name: creategroup
      description: Google Admin SDK Create group
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.creategroup
      outputParameters:
      - type: object
        mapping: $.
    - name: getgroup
      description: Google Admin SDK Get group
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.getgroup
      with:
        groupKey: tools.groupKey
      inputParameters:
      - name: groupKey
        type: string
        description: groupKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updategroup
      description: Google Admin SDK Update group
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: google-admin-sdk.updategroup
      with:
        groupKey: tools.groupKey
      inputParameters:
      - name: groupKey
        type: string
        description: groupKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: deletegroup
      description: Google Admin SDK Delete group
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: google-admin-sdk.deletegroup
      with:
        groupKey: tools.groupKey
      inputParameters:
      - name: groupKey
        type: string
        description: groupKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listmembers
      description: Google Admin SDK List group members
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listmembers
      with:
        groupKey: tools.groupKey
        maxResults: tools.maxResults
        pageToken: tools.pageToken
      inputParameters:
      - name: groupKey
        type: string
        description: groupKey
        required: true
      - name: maxResults
        type: integer
        description: maxResults
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: addmember
      description: Google Admin SDK Add group member
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.addmember
      with:
        groupKey: tools.groupKey
      inputParameters:
      - name: groupKey
        type: string
        description: groupKey
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listorgunits
      description: Google Admin SDK List organizational units
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listorgunits
      with:
        customerId: tools.customerId
      inputParameters:
      - name: customerId
        type: string
        description: customerId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: createorgunit
      description: Google Admin SDK Create organizational unit
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-admin-sdk.createorgunit
      with:
        customerId: tools.customerId
      inputParameters:
      - name: customerId
        type: string
        description: customerId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listchromeosdevices
      description: Google Admin SDK List Chrome OS devices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listchromeosdevices
      with:
        customerId: tools.customerId
        maxResults: tools.maxResults
        pageToken: tools.pageToken
      inputParameters:
      - name: customerId
        type: string
        description: customerId
        required: true
      - name: maxResults
        type: integer
        description: maxResults
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: listmobiledevices
      description: Google Admin SDK List mobile devices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listmobiledevices
      with:
        customerId: tools.customerId
        maxResults: tools.maxResults
        pageToken: tools.pageToken
      inputParameters:
      - name: customerId
        type: string
        description: customerId
        required: true
      - name: maxResults
        type: integer
        description: maxResults
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: listroles
      description: Google Admin SDK List roles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listroles
      with:
        customerId: tools.customerId
      inputParameters:
      - name: customerId
        type: string
        description: customerId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listdomains
      description: Google Admin SDK List domains
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-admin-sdk.listdomains
      with:
        customer: tools.customer
      inputParameters:
      - name: customer
        type: string
        description: customer
        required: true
      outputParameters:
      - type: object
        mapping: $.