Menu
Complete guide to all Gmail tools — inbox management, search, sending, drafts, and attachments.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Understand the @matimo/composio governance wrapper — how composio_* tools proxy Composio's 250+ integrations, what risk levels mean for approval, and how to handle missing connected accounts.
Complete guide to all Microsoft Graph tools — search, OneDrive/SharePoint files, Outlook mail, Teams, calendar, and SharePoint publishing.
Generates a smart daily briefing by analyzing Gmail and Google Calendar.
Complete guide for DBA agents managing PostgreSQL databases — query execution, performance tuning, connection monitoring, index health, and VACUUM management. USE THIS SKILL whenever the user asks to inspect, diagnose, optimize, or manage a PostgreSQL database. Triggers include: 'show me slow queries', 'check table bloat', 'what connections are active', 'find unused indexes', 'why is my DB slow', 'run this SQL', or any Postgres health/diagnostic task.
Best practices for extracting signal from Slack channel history — decisions, action items, blockers, and FYIs — and formatting them into structured reports.
A test skill to verify skill creation works
| name | gmail |
| description | Complete guide to all Gmail tools — inbox management, search, sending, drafts, and attachments. |
| version | 1.1.0 |
| license | MIT |
| metadata | {"category":"Communication","difficulty":"beginner","apply-to":"gmail-send-email gmail-list-messages gmail-get-message gmail-get-attachment gmail-create-draft gmail-delete-message","author":"Matimo","tags":"gmail,email,inbox,google"} |
Complete guide to using Matimo's Gmail tools for sending emails, inbox management, search, drafts, and attachments.
| Tool | Purpose |
|---|---|
gmail-send-email | Send a new email |
gmail-list-messages | List/search messages with Gmail query syntax and label filters |
gmail-get-message | Get full details of a message (headers, body, attachment metadata) |
gmail-get-attachment | Fetch a message attachment's raw data by ID |
gmail-create-draft | Create a draft email without sending it |
gmail-delete-message | Permanently delete a message |
Gmail tools use OAuth2. Required scopes:
https://www.googleapis.com/auth/gmail.readonly — for listing/reading messages and attachmentshttps://www.googleapis.com/auth/gmail.send — for sendinghttps://www.googleapis.com/auth/gmail.compose — for draftshttps://www.googleapis.com/auth/gmail.modify — for deleting messagesEnvironment variable: GMAIL_ACCESS_TOKEN (or GMAIL_CLIENT_ID / GMAIL_CLIENT_SECRET / GMAIL_REFRESH_TOKEN when using the OAuth2 provider flow).
Use gmail-send-email with:
to (required) — recipient email or comma-separated listsubject (required) — email subjectbody (required) — email body (supports HTML via isHtml)cc, bcc — optional recipientsBest practices:
Use gmail-create-draft with the same parameters as gmail-send-email (to, subject, body, cc, bcc, isHtml) to stage an email for manual review before sending.
gmail-list-messages handles both listing and search — pass Gmail's advanced query syntax via query, plus labelIds, maxResults, pageToken, and includeSpamTrash.
| Operator | Example | Purpose |
|---|---|---|
from: | from:alice@acme.com | From specific sender |
to: | to:team@acme.com | Sent to |
subject: | subject:invoice | In subject line |
has:attachment | Has attachments | |
is:unread | Unread messages | |
is:starred | Starred messages | |
after: | after:2024/01/01 | Date filter |
before: | before:2024/06/01 | Date filter |
label: | label:work | By label |
filename: | filename:pdf | Attachment type |
- | -from:noreply | Exclude results |
Combine operators: from:alice has:attachment after:2024/01/01. Common label IDs for labelIds: INBOX, SENT, TRASH, SPAM, DRAFT, STARRED, UNREAD (system labels) or custom user labels.
Use gmail-get-message with messageId to retrieve full headers, body, and attachment metadata (payload.parts[].body.attachmentId).
Use gmail-get-attachment with messageId and attachmentId (from gmail-get-message's payload parts) to retrieve the attachment's size and base64url-encoded data.
gmail-list-messages with labelIds: "UNREAD"gmail-list-messages with query: "is:important"gmail-get-message for eachgmail-get-attachment using attachmentId values from step 3gmail-send-email with formatted bodygmail-list-messages with query: "in:sent subject:..."| Error | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid or expired token | Refresh OAuth2 token |
403 Insufficient Permission | Missing scope | Add required Gmail scope |
400 Invalid to header | Bad email address | Validate email format |
429 Rate limit | Too many requests | Gmail API: 250 quota units/sec |