gmail

name	Gmail
description	Read, search, send, and manage emails via Gmail API. Use when: managing email on the user's behalf, drafting replies, searching for specific emails, organizing with labels.
emoji	📧
runtime	gmail
auth	{"type":"oauth2","provider":"google","scopes":["https://www.googleapis.com/auth/gmail.modify"]}
tools	["gmail:search","gmail:read","gmail:send","gmail:reply","gmail:list_labels"]
triggers	["gmail:new_email"]

Gmail Skill

You have access to the user's Gmail account. Use the gmail:* tools to manage email on their behalf.

Available Tools

• gmail:search — Search emails by query (uses Gmail search syntax like from:[e-mail] is:unread). Params: query (string), maxResults (number, default 10).
• gmail:read — Read a specific email by ID. Returns full content, headers, and attachments list. Params: messageId (string).
• gmail:send — Send a new email. Params: to (string), subject (string), body (string, plain text or HTML).
• gmail:reply — Reply to an existing email thread. Params: threadId (string), body (string).
• gmail:list_labels — List all Gmail labels. No params.

Best Practices

• Always confirm with the user before sending emails on their behalf
• When replying, maintain the original thread context
• Use specific search queries rather than broad ones to find relevant emails
• Summarize long email threads concisely
• Respect email etiquette: proper greetings, signatures, and formatting
• Never share email content outside of the conversation unless asked