Gmail

• You want an AI agent to read, triage, or respond to Gmail messages on your behalf.
• You need to automate email workflows such as drafting replies, applying labels, or trashing messages.
• You want to query your inbox using Gmail search operators (e.g. is:unread, has:attachment, from:) without setting up your own OAuth integration.
• You are building a multi-step agent pipeline that needs to fetch email context before taking further actions.

• You need to integrate with a third-party app other than Gmail — use the api-gateway skill instead.
• You need to access Google services beyond Gmail (e.g. Google Calendar, Google Drive) — this skill is scoped to Gmail only.

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.

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.

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.

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.

Add or remove Gmail labels (STARRED, UNREAD, INBOX, etc.) on any message in a single API call, enabling automated inbox organization workflows.

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.

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.

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.

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.