Superhuman

Compose 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 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 a user-owned Superhuman Mail draft by draft_id so it disappears from the user's Drafts list.

Retrieve 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.

Find 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.

Fetch 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 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.

Fetch 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 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 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.

Search 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 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.