// Gmail CLI for searching, reading threads, managing labels, and sending emails. Use when you need to check inbox, read emails, send messages, or manage email labels.
| name | gmail |
| description | Gmail CLI for searching, reading threads, managing labels, and sending emails. Use when you need to check inbox, read emails, send messages, or manage email labels. |
You have access to gmcli - a minimal Gmail CLI. All commands use the format:
gmcli <email> <command> [options]
gmcli <email> search <query> [--max N]
Query examples:
in:inbox, in:sent, in:draftsis:unread, is:starred, is:importantfrom:sender@example.com, to:recipient@example.comsubject:keywordhas:attachmentafter:2024/01/01, before:2024/12/31in:inbox is:unread from:boss@company.comExamples:
gmcli ben@factory.ai search "in:inbox" --max 10
gmcli ben@factory.ai search "is:unread" --max 50
gmcli ben@factory.ai search "from:someone@example.com has:attachment"
gmcli <email> thread <threadId>
gmcli <email> thread <threadId> --download # Download attachments
gmcli <email> labels list
gmcli <email> labels <threadIds...> --add LABEL --remove LABEL
System labels: INBOX, UNREAD, STARRED, IMPORTANT, TRASH, SPAM
Examples:
gmcli ben@factory.ai labels abc123 --remove UNREAD
gmcli ben@factory.ai labels abc123 --add STARRED
gmcli <email> send --to <emails> --subject <s> --body <b> [options]
Options:
--to <emails> - Recipients (comma-separated, required)--subject <s> - Subject line (required)--body <b> - Message body (required)--cc <emails> - CC recipients--bcc <emails> - BCC recipients--reply-to <messageId> - Reply to a message--attach <file> - Attach file (can use multiple times)Examples:
gmcli ben@factory.ai send --to someone@example.com --subject "Hi" --body "Hello there"
gmcli ben@factory.ai send --to a@x.com --subject "Re: Topic" --body "Reply" --reply-to 19aea1f2f3532db5
gmcli <email> drafts list
gmcli <email> drafts get <draftId>
gmcli <email> drafts create --to <emails> --subject <s> --body <b>
gmcli <email> drafts send <draftId>
gmcli <email> drafts delete <draftId>
gmcli <email> url <threadIds...>
--max to limit search results (default: 10)~/.gmcli/attachments/Google Calendar surface for syncing upcoming events and proposing/applying safe calendar actions.
GitHub surface for syncing auth/accounts state (read-only) via the gh CLI.
Gmail surface for syncing inbox state and proposing/applying safe triage actions.
Google Calendar CLI for listing calendars, managing events, and checking availability. Use when you need to view, create, update, or delete calendar events, check free/busy status, or list calendars.
Minimal CLI tools for Linear issue management. Use when you need to list issues, view workflow states, change issue status, or move issues between teams. Tools use Linear's GraphQL API with personal API key authentication.
Linear surface for syncing issues and proposing/applying limited workflow actions.