Gmail Integration — ModuleX AI

Overview

Add Gmail to any ModuleX agent or workflow. Gmail integration via the Gmail REST v1 API (www.googleapis.com/gmail/v1). Send email + list labels. Pure HTTP — does not depend on the google-api-python-client SDK.

Categories: Communication · Communication & Collaboration · Email · Productivity · Auth: OAuth2, Service Account / Access Token · Actions: 2

Authentication

OAuth2
Service Account / Access Token

OAuth2 Authentication

Connect using Google OAuth2 (recommended). Provides secure access to Gmail.

Required Credentials

Field	Description	Required	Format
Client ID	Google OAuth2 Client ID from Google Cloud Console	Yes	`123456789-xxxxxxxxxxxxxxxx.apps.googleusercontent.com`
Client Secret	Google OAuth2 Client Secret	Yes	`-`

OAuth Configuration

Authorization URL: https://accounts.google.com/o/oauth2/v2/auth
Token URL: https://oauth2.googleapis.com/token
Scopes: https://www.googleapis.com/auth/gmail.send, https://www.googleapis.com/auth/gmail.labels

Service Account / Access Token

Use a pre-generated access token or service account credentials

Required Credentials

Field	Description	Required	Format
Access Token	A valid Google OAuth2 access token with Gmail scopes	Yes	`-`

Available Actions

send_message — Send a new email via Gmail

Parameters

string

required

Recipient email address

string

required

Email subject line

string

required

Email body content

string

CC recipients (comma-separated)

string

BCC recipients (comma-separated)

boolean

Whether the body is HTML content (Default: false)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "thread_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Thread Id"
    },
    "label_ids": {
      "items": {
        "type": "string"
      },
      "title": "Label Ids",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SendMessageOutput",
  "type": "object"
}

list_labels — List all available Gmail labels

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "labels": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Labels",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLabelsOutput",
  "type": "object"
}

Limits & Quotas

send_message builds a base64url-encoded MIME message locally (no SDK dep).
Sending is limited to 500 messages/day (consumer accounts) or 2000/day (Google Workspace).
60s timeout for send, 30s for label listing.

Using

Providers

Building

Tools

Gmail Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Service Account / Access Token

Required Credentials

Available Actions

Parameters

Response

Response

Limits & Quotas

Microsoft Outlook

AgentMail

Mailgun

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Service Account / Access Token

​Required Credentials

​Available Actions

​Parameters

​Response

​Response

​Limits & Quotas

​Related integrations

Microsoft Outlook

AgentMail

Mailgun

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Service Account / Access Token

Required Credentials

Available Actions

Parameters

Response

Response

Limits & Quotas

Related integrations

Links