Connect to Gmail to read, send, and manage emails.
| Action | Description | Parameters | Returns |
|---|---|---|---|
batch_delete ⚠ | Batch delete messages permanently | email_ids | NoneType |
batch_modify | Batch modify labels on multiple emails | email_ids [add_labels, remove_labels] | NoneType |
create_delegate ⚠ | Add a mailbox delegate | delegate_email | Delegate |
create_draft | Create a draft email | to, subject, body [html_body, attachments, cc, bcc, reply_to, headers] | DraftId |
create_filter ⚠ | Create a new filter | criteria, action | Filter |
create_forwarding_address ⚠ | Add a forwarding address (pending verification) | forwarding_email | ForwardingAddress |
create_label | Create a new label | name [label_color] | Label |
create_send_as ⚠ | Create a send-as alias | send_as_email [display_name, reply_to_address, signature, treat_as_alias] | SendAs |
delete_delegate ⚠ | Remove a mailbox delegate | delegate_email | NoneType |
delete_draft ⚠ | Delete a draft | draft_id | NoneType |
delete_email ⚠ | Delete an email | email_id | NoneType |
delete_filter ⚠ | Delete a filter | filter_id | NoneType |
delete_forwarding_address ⚠ | Remove a forwarding address | forwarding_email | NoneType |
delete_label ⚠ | Delete a label | label_id | NoneType |
delete_send_as ⚠ | Delete a send-as alias | send_as_email | NoneType |
delete_thread ⚠ | Permanently delete a thread | thread_id | NoneType |
get_attachment | Download an email attachment | email_id, attachment_id | Attachment |
get_auto_forwarding | Get auto-forwarding settings | — | AutoForwarding |
get_delegate | Get a delegate by email | delegate_email | Delegate |
get_draft | Get a single draft by ID | draft_id [format] | Draft |
get_email | Get a single email by ID | email_id [format] | Email |
get_filter | Get a single filter by ID | filter_id | Filter |
get_forwarding_address | Get a forwarding address | forwarding_email | ForwardingAddress |
get_imap_settings | Get IMAP settings | — | ImapSettings |
get_label | Get a single label by ID | label_id | Label |
get_language | Get language settings | — | LanguageSettings |
get_pop_settings | Get POP settings | — | PopSettings |
get_profile | Get user profile | — | UserProfile |
get_send_as | Get a single send-as alias | send_as_email | SendAs |
get_thread | Get a single thread by ID | thread_id [format] | Thread |
get_vacation_settings | Get vacation auto-reply settings | — | VacationSettings |
import_message ⚠ | Import an email message into the mailbox | raw_rfc2822 [label_ids, internal_date_source] | MessageId |
insert_message ⚠ | Insert an email message directly into the mailbox | raw_rfc2822 [label_ids, internal_date_source] | MessageId |
list_delegates | List mailbox delegates | — | list |
list_drafts | List drafts | [limit, page_token] | PaginatedList[Draft] |
list_emails | List emails matching a query | [query, limit, labels, page_token] | PaginatedList[Email] |
list_filters | List all filters | — | list |
list_forwarding_addresses | List forwarding addresses | — | list |
list_history | List mailbox history | start_history_id [label_id, history_types, limit, page_token] | PaginatedList[HistoryRecord] |
list_labels | List all labels | — | list |
list_send_as | List send-as aliases | — | list |
list_threads | List email threads | [query, limit, page_token] | PaginatedList[Thread] |
mark_as_read | Mark an email as read | email_id | Email |
mark_as_unread | Mark an email as unread | email_id | Email |
modify_labels | Modify email labels | email_id [add_labels, remove_labels] | Email |
modify_thread | Modify thread labels | thread_id [add_labels, remove_labels] | Thread |
search_emails | Search emails with advanced query | query [limit, page_token] | PaginatedList[Email] |
send_draft ⚠ | Send a draft | draft_id | MessageId |
send_email ⚠ | Send an email | to, subject, body [html_body, attachments, cc, bcc, reply_to, headers] | MessageId |
star_email | Star an email | email_id | Email |
stop | Stop push notifications | — | NoneType |
trash_email | Move an email to trash | email_id | Email |
trash_thread | Move a thread to trash | thread_id | Thread |
unstar_email | Remove star from an email | email_id | Email |
untrash_email | Remove an email from trash | email_id | Email |
untrash_thread | Remove a thread from trash | thread_id | Thread |
update_auto_forwarding ⚠ | Update auto-forwarding settings | enabled [email_address, disposition] | AutoForwarding |
update_draft | Update a draft | draft_id, to, subject, body [html_body, attachments, cc, bcc, reply_to, headers] | Draft |
update_imap_settings ⚠ | Update IMAP settings | enabled [auto_expunge, expunge_behavior, max_folder_size] | ImapSettings |
update_label | Update a label | label_id [name, label_color] | Label |
update_language | Update language settings | display_language | LanguageSettings |
update_pop_settings ⚠ | Update POP settings | [access_window, disposition] | PopSettings |
update_send_as | Update a send-as alias | send_as_email [display_name, reply_to_address, signature, is_default, treat_as_alias] | SendAs |
update_vacation_settings ⚠ | Update vacation auto-reply settings | enable [response_subject, response_body, start_time, end_time] | VacationSettings |
verify_send_as | Re-send verification for a pending send-as | send_as_email | NoneType |
watch ⚠ | Start receiving mailbox-change push notifications | topic_name [label_ids, label_filter_behavior] | dict |
Full schema explorer, code generation, and live API testing