create_or_update_draft
ChatGPTCompose an email on behalf of the user. Uses the user's writing style, tone, and personalization to produce a polished draft. Returns the composed email — use send_draft separately to send it. The draft is saved to the user's Superhuman Mail Drafts list. The response includes a draft object with draft_id and thread_id — pass draft_id to send_draft to send the email. To update an existing draft (e.g. after user feedback), pass the previous draft_id and thread_id — the existing draft's content (recipients, subject, body) is loaded so the writer can revise it based on your instructions rather than composing from scratch. The draft will be updated in place instead of creating a duplicate. Forward drafts are a temporary exception: use body, not instructions, and provide only your intro text — the server appends the forwarded message automatically.
create_or_update_event
ChatGPTCreate a new calendar event or edit an existing one. If event_id is provided, updates the existing event. Otherwise creates a new event. Note: newly created or updated events may take up to a minute to appear in search and query results.
discard_draft
ChatGPTDiscard a user-owned Superhuman Mail draft by draft_id so it disappears from the user's Drafts list.
get_attachment
ChatGPTRetrieve email attachments. For images and audio files, returns both the file content (for direct processing) and a download URL. For other file types, returns a download URL only. Download URLs expire after 1 hour. Requires a message_id obtained from get_message or get_thread.
get_availability
ChatGPTFind available meeting times for a group of participants. Resolves names to emails, checks availability, and returns proposed time slots. Use create_or_update_event afterward to create the meeting.
get_message
ChatGPTFetch a single email message by its message ID. Returns full message details including body text. Use include_raw_html to also retrieve the original HTML. Requires a message_id obtained from list_email or get_thread.
get_read_status_feed
ChatGPTGet a feed of read receipts for emails you've sent — who opened them, when, and on what device. Returns events newest first. By default scans the last 14 days of sent mail (up to 500 messages) and returns read events from the last 24 hours.
get_thread
ChatGPTFetch a specific email thread by its thread ID. Returns structured message data including bodies, recipients, and attachments. Requires a thread_id obtained from query_email_and_calendar or list_threads.
list_labels
ChatGPTList all labels available on the user's email account. Returns user-created labels that can be used with list_threads (labels filter) and update_thread (add_labels / remove_labels).
list_splits
ChatGPTList the user's inbox splits. Splits organize the inbox into sections like Important, Other, and user-created categories (VIP, News, Team, etc.). Returns each split's name, filter criteria, and thread/unread counts. Use split names with the list_threads tool's split filter to view threads in a specific split. Note: counts reflect the last mailbox sync and may be a few seconds behind.
list_threads
ChatGPTSearch email threads with structured filters. Returns thread metadata with participants, labels, and a snippet of the latest message. Supports pagination for large result sets. No filters returns the most recent threads. Note: recently sent or received messages may take up to a minute to appear in results.
mark_spam
ChatGPTMark an email thread as spam by thread ID. When also_block_sender or also_block_domain is set, the sender or domain is blocked and a bulk action runs in the background to mark all existing inbox threads from that sender or domain as spam.
query_email_and_calendar
ChatGPTAnswer natural-language questions about the user's emails, calendar, contacts, and knowledge base. Best for open-ended, exploratory, or ambiguous requests — inbox triage, summarizing conversations, checking schedules, or any question that spans multiple sources. Understands context and reasons across email and calendar together. Note: recently sent emails or newly created calendar events may take up to a minute to appear in results.
send_draft
ChatGPTSend an existing Superhuman Mail draft. Pass draft_id from create_or_update_draft. Optionally use smart_send to schedule at the best engagement time, send_at to schedule at a specific time, or undo_timeout to delay sending by up to 10 minutes so the send can be cancelled via undo_send. When no scheduling option is provided, send_draft applies a default 1-minute undo-send delay. Note: after sending, the message may take up to a minute to appear in search results or thread listings.
trash_thread
ChatGPTMove an email thread to trash by thread ID. This is a destructive operation, the thread will be removed from the inbox and placed in the trash folder.
undo_send
ChatGPTCancel a recently queued send while still within the undo window. Use the undo_token returned by send_draft (preferred), or the message_id from send_draft as a fallback. The draft remains in the Drafts list either way.
unsubscribe
ChatGPTUnsubscribe from a mailing list by thread ID based on the List-Unsubscribe header of the latest message in the thread. Optionally trash the thread and/or block the sender.
update_personalization
ChatGPTUpdate the user's personalization based on natural language feedback. Use this when the user wants to correct their writing style, update personal facts, change greeting/sign-off preferences, or adjust any personalization setting.
update_thread
ChatGPTUpdate an email thread: mark done/not done, star/unstar, read/unread, move between Important and Other, add or remove labels, or move to a folder. Multiple changes can be made in a single call.
create_or_update_draft
Claudecreate_or_update_event
Claudediscard_draft
Claudeget_attachment
Claudeget_availability
Claudeget_labels
Claudeget_message
Claudeget_read_statuses
Claudeget_thread
Claudelist_splits
Claudelist_threads
Claudemark_spam
Claudequery_email_and_calendar
Claudesend_draft
Claudetrash_thread
Claudeundo_send
Claudeunsubscribe
Claudeupdate_personalization
Claudeupdate_thread
Claude
