# Gmail

> 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.

- Skill: `outworked/gmail` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add outworked/gmail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/outworked/gmail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: outworked (https://skillmd.com/u/outworked)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/outworked/gmail

---


# 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:boss@company.com 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