Gmail · agentio

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 list

List 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 search

Search messages using Gmail query syntax

--query <query> --profile <name> --limit <n> --ids-only
agentio gmail send

Send 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 draft

Create 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 list

List 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 list

List all filters

--profile <name>
agentio gmail filters get <id>

Get a filter

--profile <name>
agentio gmail filters create

Create 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_list

List messages
gmail_get

Get a message
gmail_search

Search messages using Gmail query syntax
gmail_send

Send an email
gmail_draft

Create an email draft
gmail_archive

Archive one or more messages (bulk-safe via batchModify)
gmail_mark

Mark one or more messages as read or unread
gmail_labels_list

List all labels
gmail_labels_create

Create a new label
gmail_labels_delete

Delete a user label
gmail_labels_rename

Rename a user label
gmail_filters_list

List all filters
gmail_filters_get

Get a filter
gmail_filters_create

Create a Gmail filter
gmail_filters_delete

Delete one or more filters
gmail_label

Apply and/or remove labels on messages or threads (bulk-safe via batchModify)
gmail_attachment

Download attachments from a message
gmail_export

Export 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

📧 Gmail

What you can do

Setup

Command reference

MCP tools

Related changelog entries