🎨

Gmail

Read, send, and manage Gmail messages, threads, labels, and drafts via managed OAuth — no token handling required.

byungkyuv1.0.6
Design & MediaAutomationAPIAI PoweredProductivity
Connecting to VM...
Connecting to VM...
npx clawhub@latest install gmail
52Stars
20.4kDownloads
989Current Installs
144All-time Installs
📦
v1.0.6Version
📅
Feb 26, 2026Updated

Requirements

Maton API Key
View Source(ClawHub)

Supported operations include reading and sending messages, managing threads, applying or removing labels, creating and sending drafts, and querying messages with Gmail's native search operators.

This skill gives AI agents full access to the Gmail API through Maton's managed OAuth gateway. Instead of handling Google OAuth flows yourself, you authenticate once via Maton and all requests are proxied with your OAuth token automatically injected.

Key Features

Managed OAuth — No Token Handling
Authentication is handled by Maton's gateway. You connect your Google account once at `ctrl.maton.ai`, and all subsequent API calls automatically receive a valid OAuth token. No need to manage refresh tokens or OAuth scopes yourself.
Full Gmail API Coverage
Supports listing and reading messages, sending messages, listing and fetching threads, managing labels, trashing messages, and creating or sending drafts. The gateway proxies directly to `gmail.googleapis.com` using native Gmail API paths.
Powerful Message Querying
Use Gmail's native `q` parameter with operators like `is:unread`, `from:`, `subject:`, `has:attachment`, and date ranges to precisely filter messages without additional parsing logic.
Multi-Account Support
Manage multiple Gmail connections under a single Maton API key. Specify which account to use per request via the `Maton-Connection` header, or let the gateway default to your primary active connection.
Label Management
Add or remove Gmail labels (`STARRED`, `UNREAD`, `INBOX`, etc.) on any message in a single API call, enabling automated inbox organization workflows.

Requirements

Required before making any Gmail API calls.

- **Maton API Key** *(required)* — Authenticates all requests through the Maton gateway. Obtain at [maton.ai/settings](https://maton.ai/settings). - **Google OAuth Connection** *(required)* — A connected Google account authorized via [ctrl.maton.ai](https://ctrl.maton.ai).

Use Cases

Inbox Triage Agent
An AI agent lists unread messages using `q=is:unread`, reads each message body, categorizes them, applies labels, and marks low-priority emails as read — all without any manual intervention.
Automated Email Drafting
Given a prompt or trigger (e.g. a new lead form submission), an agent creates a Gmail draft with a personalized response and either saves it for human review or sends it immediately via the Send Draft endpoint.
Email-Based Data Extraction
An agent queries emails by sender or subject keyword, retrieves message content, and extracts structured data (e.g. invoice details, order confirmations) for downstream processing or storage.
Thread Monitoring and Summarization
An agent fetches full email threads on a schedule, summarizes conversation history, and surfaces action items — useful for monitoring customer support threads or project discussions.

How to Install

1
Run in your terminal
npx clawhub@latest install gmail
or
2
Click the Install button at the top of this page for one-click setup

FAQ