# Gmail MCP Integration

> Gmail ofrece correo electrónico privado y seguro de Google sin costo, para cuentas empresariales y de consumo.

## Overview

| Property | Value |
|----------|-------|
| Category | Comunicación |
| Type | PIPEDREAM |
| Tools | 22 |
| URL | https://jelou.ai/pt-br/marketplace/gmail |

## Available Tools (22)

### Añadir etiqueta al correo electrónico

Agregar etiqueta(s) a un mensaje de correo electrónico. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)

### Aprobar flujo de trabajo

Suspende el flujo de trabajo hasta que sea aprobado por correo electrónico. [Ver la documentación](https://pipedream.com/docs/code/nodejs/rerun#flowsuspend)

### Archivar correo

Archivar un mensaje de correo electrónico. [Consulta la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)

Devuelve solo el texto traducido sin explicaciones.

### Bulk Archive Emails

Archive multiple emails at once. [See the documentation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/batchModify)

### Crear borrador

Crea un borrador desde tu cuenta de correo de Google Workspace. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.drafts/create)

### Crear Etiqueta

Cree una nueva etiqueta en la cuenta conectada. [Consulte la documentación](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/create)

### Eliminar correo electrónico

Mueve el mensaje especificado a la papelera. [Ver la documentación](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/trash)

### Delete Label

Immediately and permanently delete a user-created label from the authenticated Gmail mailbox, removing it from every message and thread it was applied to. Only user-created labels can be deleted — Gmail's built-in system labels (`INBOX`, `SENT`, `SPAM`, `TRASH`, etc.) cannot. This deletes the label *definition* itself; to merely detach a label from specific messages without removing it, use **Modify Labels** with `removeLabels` instead. [See the documentation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/delete).

### Descargar adjunto

Descargue un adjunto por attachmentId en el directorio /tmp. [Consulte la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages.attachments/get)

Devuelva solo el texto traducido sin explicaciones.

### Buscar correo electrónico

Encuentra un correo electrónico utilizando el motor de búsqueda de Google. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages.list)

### Get Current User

Returns the authenticated Gmail user's name, email address, and mailbox stats (total messages and threads). Call this first when the user says 'my emails', 'my inbox', or needs identity context. Use the returned `emailAddress` to identify the user's own messages in **Find Emails** results. [See the documentation](https://developers.google.com/gmail/api/reference/rest/v1/users/getProfile).

### Obtener Enviar como alias

Obtener un alias de envío para el usuario autenticado. [Ver la documentación](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.sendAs/get)

### List Send as a Delegate Options

Retrieves available options for the Send as a Delegate field.

### Listar Etiquetas

Lista todas las etiquetas existentes en la cuenta conectada. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list)

### Lista de alias para Enviar como

Listar todos los alias de envío para el usuario autenticado. [Consulta la documentación](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.sendAs/list)

### List Signature Options

Retrieves available options for the Signature field.

### Listar mensajes del hilo

Listar mensajes en un hilo. [Ver la documentación](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get)

Devuelva solo el texto traducido sin explicaciones.

### Modify Labels

Add and/or remove labels on one or more Gmail messages in a single call. In Gmail, most inbox-state operations are label mutations under the hood, so this one tool covers archive / trash / untrash / star / unstar / mark-read / mark-unread / apply-label / remove-label.

**Use this whenever the user asks you to star, unstar, flag, archive, file, sort, label, tag, categorise, move, trash, delete, restore, or mark mail as read or unread** — there is no separate tool for any of those. Pair it with **Find Emails** to turn a description of the mail ("the invoice from billing", "everything from last week") into the `messageIds` this tool needs. Apply it even when some messages already carry the target state: the operation is idempotent, and the user asked for an outcome, not a diff.

**Do NOT use this to set up filters, rules, or any automation that applies to mail that has not arrived yet.** This tool labels messages that already exist, one batch at a time. Gmail filters, auto-forwarding, and the vacation responder are settings-level features with no action in this set — if the user asks to "automatically label incoming mail", "skip the inbox from now on", or "set up a rule", say so outright rather than gathering criteria you cannot act on, and point them at Gmail's own settings.

⚠️ **Trashing is destructive — confirm before you do it.** Adding `TRASH` removes mail from the mailbox, and nothing in this tool set can permanently delete or restore in bulk beyond untrashing. When the request would trash mail the user did not enumerate individually ("trash everything from X", "clear out this label", "delete the old ones"), first say how many messages match and what they are, and get explicit confirmation. Every other operation here is safely reversible and needs no confirmation.

Common recipes (pass these in `addLabels` / `removeLabels`):
- **Archive** → `removeLabels: ["INBOX"]`
- **Move to trash** → `addLabels: ["TRASH"]`
- **Untrash (restore)** → `removeLabels: ["TRASH"]`, `addLabels: ["INBOX"]`
- **Star** → `addLabels: ["STARRED"]`
- **Unstar** → `removeLabels: ["STARRED"]`
- **Mark read** → `removeLabels: ["UNREAD"]`
- **Mark unread** → `addLabels: ["UNREAD"]`
- **Apply a user label** → `addLabels: ["Clients/Acme"]` (pass the name or the label ID)
- **Apply user label AND archive** → `addLabels: ["Clients/Acme"]`, `removeLabels: ["INBOX"]`

`addLabels` and `removeLabels` accept either raw label IDs (system labels like `INBOX`, `STARRED`, `UNREAD`, `TRASH`) or user-visible label names — names are resolved via **List Labels** before the API call. Use **Create Label** first if you need to apply a brand-new label that doesn't yet exist. [See the documentation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/batchModify).

### Eliminar etiqueta del correo

Eliminar la(s) etiqueta(s) de un mensaje de correo electrónico. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify)

Devuelva solo el texto traducido sin explicaciones.

### Enviar correo electrónico

Envía un correo desde tu cuenta de Google Workspace. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.messages.send)

### Actualizar la firma de correo electrónico en la organización

Actualice la firma para una dirección de correo electrónico específica en una organización.
    Se requiere una cuenta de servicio de Google Cloud con autoridad delegada a nivel de dominio para esta acción. [Ver la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.settings.sendAs/update)

Devuelva solo el texto traducido sin explicaciones.

### Actualizar firma para la dirección de correo electrónico principal

Actualice la firma para la dirección de correo electrónico principal. [Consulte la documentación](https://developers.google.com/gmail/api/reference/rest/v1/users.settings.sendAs/update)

## Supported Channels

This integration works with:
- WhatsApp Business API
- Facebook Messenger
- Instagram Direct Messages
- Web Chat Widget

## AI Assistants Compatible

- ChatGPT (via MCP)
- Claude (via MCP)
- Gemini (via MCP)
- Custom AI Agents

## Quick Start

1. Sign up at https://apps.jelou.ai/signup
2. Navigate to Marketplace and add Gmail
3. Authenticate your Gmail account
4. Configure your messaging channels (WhatsApp, Facebook, etc.)
5. Copy the MCP server URL to your AI assistant

## Example Use Cases

- Automate customer inquiries using Gmail data
- Send notifications via WhatsApp when Gmail events occur
- Query Gmail data directly from ChatGPT or Claude
- Build AI agents that interact with Gmail

## Resources

- [All Integrations](https://jelou.ai/pt-br/marketplace)
- [Full Documentation](https://jelou.ai/llms-full.txt)
- [API Docs](https://docs.jelou.ai)
- [Help Center](https://help.jelou.ai)
