OAuth
📧 Gmail
Read, search, send, label, and export email at scale.
What you can do
- Pull unread threads into structured JSON for an LLM to summarize
- Send drafts and replies, with attachments
- Manage labels and filters declaratively
- Export messages as PDF for archival
Setup
agentio gmail profile add
Command reference
-
agentio gmail listList messages
--profile <name>--limit <n>--query <query>--label <label> -
agentio gmail get <message-id>Get a message
--profile <name>--format <format>--body-only -
agentio gmail searchSearch messages using Gmail query syntax
--query <query>--profile <name>--limit <n>--ids-only -
agentio gmail sendSend an email
--profile <name>--to <email>--cc <email>--bcc <email>--subject <subject>--body <body>--html--reply-to <thread-id>--attachment <path>--inline <cid:path> -
agentio gmail draftCreate an email draft
--profile <name>--to <email>--cc <email>--bcc <email>--subject <subject>--body <body>--html--reply-to <thread-id>--attachment <path>--inline <cid:path> -
agentio gmail archive [message-id...]Archive one or more messages (bulk-safe via batchModify)
--profile <name>--chunk-size <n>--max-retries <n>--dry-run -
agentio gmail mark <message-id...>Mark one or more messages as read or unread
--profile <name>--read--unread -
agentio gmail labels listList all labels
--profile <name> -
agentio gmail labels create <name>Create a new label
--profile <name> -
agentio gmail labels delete <name-or-id>Delete a user label
--profile <name> -
agentio gmail labels rename <old> <new>Rename a user label
--profile <name> -
agentio gmail filters listList all filters
--profile <name> -
agentio gmail filters get <id>Get a filter
--profile <name> -
agentio gmail filters createCreate a Gmail filter
--profile <name>--from <email>--to <email>--subject <text>--query <q>--negated-query <q>--has-attachment--exclude-chats--size <bytes>--size-comparison <cmp>--apply <label>--remove <label>--forward <email> -
agentio gmail filters delete <id...>Delete one or more filters
--profile <name> -
agentio gmail label [id...]Apply and/or remove labels on messages or threads (bulk-safe via batchModify)
--profile <name>--apply <name>--remove <name>--thread--chunk-size <n>--max-retries <n>--dry-run -
agentio gmail attachment <message-id>Download attachments from a message
--profile <name>--name <filename>--output <dir> -
agentio gmail export <message-id>Export a message as PDF
--profile <name>--output <path>
MCP tools
-
gmail_listList messages
-
gmail_getGet a message
-
gmail_searchSearch messages using Gmail query syntax
-
gmail_sendSend an email
-
gmail_draftCreate an email draft
-
gmail_archiveArchive one or more messages (bulk-safe via batchModify)
-
gmail_markMark one or more messages as read or unread
-
gmail_labels_listList all labels
-
gmail_labels_createCreate a new label
-
gmail_labels_deleteDelete a user label
-
gmail_labels_renameRename a user label
-
gmail_filters_listList all filters
-
gmail_filters_getGet a filter
-
gmail_filters_createCreate a Gmail filter
-
gmail_filters_deleteDelete one or more filters
-
gmail_labelApply and/or remove labels on messages or threads (bulk-safe via batchModify)
-
gmail_attachmentDownload attachments from a message
-
gmail_exportExport a message as PDF
Related changelog entries
- feat add 'filters delete' command d8128ae
- feat add 'filters create' command e78684b
- feat add 'filters list' and 'filters get' commands 259f95d
- feat add filter output formatters 85b6784
- feat add filter CRUD client methods 67b6c3c
- feat add filter types 84023a3
- feat add gmail.settings.basic scope for filter management 8132cb2
- feat bulk archive/label via batchModify, paginated search 6f839ea
- feat add LLM-friendly examples to all gmail commands 177d19e
- fix add gmail.modify scope for label and modify operations 6e06af0
- feat add label CRUD and apply/remove commands e381ba4
- feat add attachment download support e2ecbb2
- fix lazy load playwright-core to fix native builds f96f158
- fix preserve original HTML styling in PDF export 695e78b
- fix lazy load playwright-core to fix native builds f1d9e43
- fix preserve original HTML styling in PDF export da5251e
- feat add attachment download support b871868