gmail-skill

Prepare Gmail messages without sending them: create, update, list, send, and delete drafts, with attachments. Use when the user asks to draft, prepare, or write up an email, to save something for later, to revise a draft, or to send one they already approved. Prefer this over sending directly whenever the exact wording has not been agreed yet: a draft is reviewable in Gmail and costs nothing to throw away.

Organize the user's Gmail: apply and remove labels, archive, mark read or unread, star, move to trash or restore, and manage the label list itself. Use when the user asks to label, tag, file, sort, archive, clean up, triage, or clear their inbox, to mark mail as read, to star something, or to delete or restore messages. Works on single messages or whole threads.

Search and read the user's Gmail: find messages, open one or a whole thread, and list or download attachments. Use when the user asks what is in their inbox, whether someone emailed them, to check or summarize mail, to find a message about a topic or from a person, to read a thread, or to save a file someone sent. Read-only: it never sends, labels, or deletes anything.

Send Gmail: a new message, a threaded reply, or a forward, with file attachments. Use when the user asks to send, email, reply to, answer, or forward something, or to send a file or document to someone. Sending is irreversible, so this always previews first and waits for an explicit go-ahead. If the wording is not settled yet, draft it instead.

Connect a Gmail account to this machine, and diagnose it when Gmail calls start failing. Use when the user wants to set up, connect, or authorize Gmail; when they add a second account; when they ask why email stopped working; or when any gmail command returns auth_required, auth_expired, scope_insufficient, client_invalid, or api_not_enabled. Covers the one-time Google Cloud project and OAuth client, the login flow, multiple accounts as profiles, and `gmail doctor`.