Google Chat API

naftiko: 1.0.0-alpha2
info:
  label: Google Chat API
  description: The Google Chat API enables building Chat apps that integrate with Google Chat. It provides RESTful access
    to manage spaces, memberships, messages, reactions, media, and custom emojis.
  tags:
  - Google
  - Chat
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-chat
    baseUri: https://chat.googleapis.com
    description: Google Chat API HTTP API.
    resources:
    - name: v1-spaces
      path: /v1/spaces
      operations:
      - name: listspaces
        method: GET
        description: Google Chat List spaces
        inputParameters:
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createspace
        method: POST
        description: Google Chat Create space
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-name
      path: /v1/{name}
      operations:
      - name: getspace
        method: GET
        description: Google Chat Get space
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
          description: 'Format: spaces/{space}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatespace
        method: PATCH
        description: Google Chat Update space
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        - name: updateMask
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletespace
        method: DELETE
        description: Google Chat Delete space
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-spaces-setup
      path: /v1/spaces:setup
      operations:
      - name: setupspace
        method: POST
        description: Google Chat Setup space
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-parent-members
      path: /v1/{parent}/members
      operations:
      - name: listmembers
        method: GET
        description: Google Chat List members
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
          description: 'Format: spaces/{space}'
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createmember
        method: POST
        description: Google Chat Create member
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-parent-messages
      path: /v1/{parent}/messages
      operations:
      - name: listmessages
        method: GET
        description: Google Chat List messages
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
          description: 'Format: spaces/{space}'
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createmessage
        method: POST
        description: Google Chat Create message
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-parent-reactions
      path: /v1/{parent}/reactions
      operations:
      - name: listreactions
        method: GET
        description: Google Chat List reactions
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
          description: 'Format: spaces/{space}/messages/{message}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createreaction
        method: POST
        description: Google Chat Create reaction
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-customemojis
      path: /v1/customEmojis
      operations:
      - name: listcustomemojis
        method: GET
        description: Google Chat List custom emojis
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createcustomemoji
        method: POST
        description: Google Chat Create custom emoji
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-chat-rest
    description: REST adapter for Google Chat API.
    resources:
    - path: /v1/spaces
      name: listspaces
      operations:
      - method: GET
        name: listspaces
        description: Google Chat List spaces
        call: google-chat.listspaces
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/spaces
      name: createspace
      operations:
      - method: POST
        name: createspace
        description: Google Chat Create space
        call: google-chat.createspace
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{name}
      name: getspace
      operations:
      - method: GET
        name: getspace
        description: Google Chat Get space
        call: google-chat.getspace
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{name}
      name: updatespace
      operations:
      - method: PATCH
        name: updatespace
        description: Google Chat Update space
        call: google-chat.updatespace
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{name}
      name: deletespace
      operations:
      - method: DELETE
        name: deletespace
        description: Google Chat Delete space
        call: google-chat.deletespace
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/spaces:setup
      name: setupspace
      operations:
      - method: POST
        name: setupspace
        description: Google Chat Setup space
        call: google-chat.setupspace
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/members
      name: listmembers
      operations:
      - method: GET
        name: listmembers
        description: Google Chat List members
        call: google-chat.listmembers
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/members
      name: createmember
      operations:
      - method: POST
        name: createmember
        description: Google Chat Create member
        call: google-chat.createmember
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/messages
      name: listmessages
      operations:
      - method: GET
        name: listmessages
        description: Google Chat List messages
        call: google-chat.listmessages
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/messages
      name: createmessage
      operations:
      - method: POST
        name: createmessage
        description: Google Chat Create message
        call: google-chat.createmessage
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/reactions
      name: listreactions
      operations:
      - method: GET
        name: listreactions
        description: Google Chat List reactions
        call: google-chat.listreactions
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{parent}/reactions
      name: createreaction
      operations:
      - method: POST
        name: createreaction
        description: Google Chat Create reaction
        call: google-chat.createreaction
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/customEmojis
      name: listcustomemojis
      operations:
      - method: GET
        name: listcustomemojis
        description: Google Chat List custom emojis
        call: google-chat.listcustomemojis
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/customEmojis
      name: createcustomemoji
      operations:
      - method: POST
        name: createcustomemoji
        description: Google Chat Create custom emoji
        call: google-chat.createcustomemoji
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-chat-mcp
    transport: http
    description: MCP adapter for Google Chat API for AI agent use.
    tools:
    - name: listspaces
      description: Google Chat List spaces
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.listspaces
      with:
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: pageSize
        type: integer
        description: pageSize
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: createspace
      description: Google Chat Create space
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.createspace
      outputParameters:
      - type: object
        mapping: $.
    - name: getspace
      description: Google Chat Get space
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.getspace
      with:
        name: tools.name
      inputParameters:
      - name: name
        type: string
        description: 'Format: spaces/{space}'
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updatespace
      description: Google Chat Update space
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.updatespace
      with:
        name: tools.name
        updateMask: tools.updateMask
      inputParameters:
      - name: name
        type: string
        description: name
        required: true
      - name: updateMask
        type: string
        description: updateMask
      outputParameters:
      - type: object
        mapping: $.
    - name: deletespace
      description: Google Chat Delete space
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: google-chat.deletespace
      with:
        name: tools.name
      inputParameters:
      - name: name
        type: string
        description: name
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: setupspace
      description: Google Chat Setup space
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.setupspace
      outputParameters:
      - type: object
        mapping: $.
    - name: listmembers
      description: Google Chat List members
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.listmembers
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: parent
        type: string
        description: 'Format: spaces/{space}'
        required: true
      - name: pageSize
        type: integer
        description: pageSize
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: createmember
      description: Google Chat Create member
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.createmember
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listmessages
      description: Google Chat List messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.listmessages
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: parent
        type: string
        description: 'Format: spaces/{space}'
        required: true
      - name: pageSize
        type: integer
        description: pageSize
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: createmessage
      description: Google Chat Create message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.createmessage
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listreactions
      description: Google Chat List reactions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.listreactions
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: 'Format: spaces/{space}/messages/{message}'
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: createreaction
      description: Google Chat Create reaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.createreaction
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listcustomemojis
      description: Google Chat List custom emojis
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-chat.listcustomemojis
      outputParameters:
      - type: object
        mapping: $.
    - name: createcustomemoji
      description: Google Chat Create custom emoji
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-chat.createcustomemoji
      outputParameters:
      - type: object
        mapping: $.