Skip to main content

MCP tools

What Claude / ChatGPT / any other MCP client can do through inboxmcp. Which tools are available depends on your plan.

Read tools (all plans)

ToolDescription
list_mailboxesMailboxes available on the account
list_foldersFolder tree of a mailbox
search_mailsSearch per folder (full text, sender, date, flags)
read_mailFull message body and attachments
read_mail_chunkRead a very long message in parts
get_attachmentDeliver an attachment via a short-lived signed URL
list_capabilitiesWhich tools the current plan unlocks

Write tools (Premium / Business)

ToolDescription
draft_mailCreate a draft (reply / forward aware, auto-quotes the original)
edit_draftRevise an existing draft
create_folderCreate a new folder
move_mailsMove messages to another folder
send_mailSend a mail — the MCP client asks for confirmation before dispatch

Further write tools (flag_mail, delete_mail) are on the roadmap.

Security — what's inside read_mail

Mail bodies returned from read_mail and read_mail_chunk are wrapped in <untrusted_mail_body>…</untrusted_mail_body> markers. The AI assistant sees a clean boundary between instructions (your chat input) and data (someone else's mail content), so a directive smuggled into a mail body — the classic "ignore all previous instructions" — doesn't get followed as an instruction. Details at Security & privacy.

Every tool call lands in the audit log — Business accounts can view it in the portal.