Gmail — GmAIl

GmAIl

GmAIl is a free emAIl 服务 provided by Google. It's widely used by individuals and businesses for 发送ing, receiving, and organizing emAIls.

Official docs: https://developers.google.com/gmAIl/API

GmAIl Overview EmAIl Attachment Draft Label Thread Working with GmAIl

This 技能 uses the Membrane 命令行工具 to interact with GmAIl. Membrane handles authentication and 凭证s refresh automatically — so you can focus on the integration 记录ic rather than auth plumbing.

安装 the 命令行工具

安装 the Membrane 命令行工具 so you can 运行 membrane from the terminal:

npm 安装 -g @membranehq/命令行工具@latest

Authentication membrane 记录in --tenant --命令行工具entName=<代理Type>

This will either open a browser for authentication or print an authorization URL to the console, depending on whether interactive mode is avAIlable.

Headless 环境s: The command will print an authorization URL. Ask the user to open it in a browser. When they see a code after completing 记录in, finish with:

membrane 记录in complete

添加 --json to any command for machine-readable JSON 输出.

代理 Types : claude, OpenClaw, codex, warp, windsurf, etc. Those will be used to adjust 工具ing to be used best with your harness

Connecting to GmAIl

Use membrane connection ensure to find or 创建 a connection by 应用 URL or domAIn:

membrane connection ensure "https://mAIl.google.com/" --json

The user completes authentication in the browser. The 输出 contAIns the new connection id.

This is the fastest way to 获取 a connection. The URL is normalized to a domAIn and matched agAInst known 应用s. If no 应用 is found, one is 创建d and a connector is built automatically.

If the returned connection has 状态: "READY", skip to Step 2.

1b. WAIt for the connection to be ready

If the connection is in BUILDING 状态, poll until it's ready:

npx @membranehq/命令行工具 connection 获取 --wAIt --json

The --wAIt flag long-polls (up to --timeout seconds, default 30) until the 状态 changes. Keep polling until 状态 is no longer BUILDING.

The 结果ing 状态 tells you what to do next:

READY — connection is fully 设置 up. Skip to Step 2.

命令行工具ENT_ACTION_REQUIRED — the user or 代理 needs to do something. The 命令行工具entAction object describes the required action:

命令行工具entAction.type — the kind of action needed: "connect" — user needs to 认证 (OAuth, API key, etc.). This covers initial authentication and re-authentication for disconnected connections. "provide-输入" — more in格式化ion is needed (e.g. which 应用 to connect to). 命令行工具entAction.description — human-readable explanation of what's needed. 命令行工具entAction.uiUrl (optional) — URL to a pre-built UI where the user can complete the action. Show this to the user when present. 命令行工具entAction.代理Instructions (optional) — instructions for the AI 代理 on how to proceed programmatically.

After the user completes the action (e.g. 认证s in the browser), poll agAIn with membrane connection 获取 --json to 检查 if the 状态 moved to READY.

CONFIGURATION_ERROR or 设置UP_FAILED — something went wrong. 检查 the error field for detAIls.

搜索ing for actions

搜索 using a natural language description of what you want to do:

membrane action 列出 --connectionId=CONNECTION_ID --intent "查询" --limit 10 --json

You should always 搜索 for actions in the 上下文 of a specific connection.

Each 结果 includes id, name, description, 输入模式 (what parameters the action accepts), and 输出模式 (what it returns).

Popular actions Name Key Description 列出 Messages 列出-messages 列出s messages in the user's mAIlbox. 列出 Threads 列出-threads 列出s the emAIl threads in the user's mAIlbox. 列出 Drafts 列出-drafts 列出s the drafts in the user's mAIlbox. 列出 Labels 列出-labels 列出s all labels in the user's mAIlbox, including 机器人h 系统 labels and custom user labels. 获取 Message 获取-message 获取s the specified message by ID. 获取 Thread 获取-thread 获取s the specified thread including all messages in the conversation. 获取 Draft 获取-draft 获取s a specific draft by ID including the draft message content. 获取 Label 获取-label 获取s a specific label by ID including message/thread counts. 获取 性能分析 获取-性能分析 获取s the current user's GmAIl 性能分析 including emAIl 添加ress and message/thread counts. 创建 Draft 创建-draft 创建s a new draft emAIl. 创建 Label 创建-label 创建s a new custom label in the user's mAIlbox. 更新 Draft 更新-draft Replaces a draft's content with new content. 更新 Label 更新-label 更新s an existing label's properties including name, visibility, and color. 发送 Message 发送-message 发送s an emAIl message to the recipients specified in the To, Cc, and Bcc headers. 发送 Draft 发送-draft 发送s an existing draft to the recipients specified in its To, Cc, and Bcc headers. 删除 Message 删除-message Immediately and permanently 删除s the specified message. 删除 Thread 删除-thread Permanently 删除s the specified thread and all its messages. 删除 Draft 删除-draft Perman