Agent-Native Mail MCP Server: Setup for Claude, Cursor and Other Apps

• Lists emails from a mailbox view, with optional search

  Shows the emails in your inbox, unread, starred, sent, drafts, scheduled, archive or trash, and can filter them with a search. It only reads.

  Try: “List my unread emails from this week.”

  Network · list-emails

• Reads one email in full without marking it read

  Opens a single email with its full text and details. It leaves the unread flag and labels alone.

  Try: “Open the latest email from my accountant and summarize it.”

  Network · get-email

• Reads a whole email thread without marking it read

  Reads every message in one conversation, with an option for a short summary. It does not mark anything as read.

  Try: “Read the thread about the Q3 contract and list the open questions.”

  Network · get-thread

• Makes a one-off upload link for a file you want to attach

  Creates a short-lived upload address so a local file can be attached to a draft or an approved send. It does not send anything by itself.

  Try: “Attach report.pdf to a draft reply to Sam.”

  Write · create-attachment-upload

• Creates, edits and deletes compose drafts

  Writes new drafts, revises existing ones and can delete one draft, a saved mailbox draft, or all compose drafts. Deleting asks for your approval when an outside assistant calls it.

  Try: “Draft a reply to Priya saying I can meet Thursday at 3pm.”

  Delete · manage-draft

• Hands a request to the app's own AI agent and returns its answer

  Sends your request to the app's built-in assistant, which does the work inside the app. Use it for anything the direct tools below do not cover. Long jobs come back as a task you check on later.

  Try: “Ask the app to archive everything in my inbox from newsletters and tell me how many you moved.”

  Write · ask_app

• Checks on a long ask_app task until it finishes

  Checks whether a long request you handed to the app has finished and returns the result. It only reads status.

  Try: “Check whether that task has finished.”

  Network · ask_app_status

• Lists the Agent-Native apps you can reach and their URLs

  Shows which Agent-Native apps your account can reach and where they live. It changes nothing.

  Try: “Which Agent-Native apps do I have access to?”

  Read · list_apps

• Builds a link that opens the app at a specific view or record

  Gives you a link that opens the app on the right screen or record. It does not change anything.

  Try: “Give me a link that opens the app on my unread emails.”

  Read · open_app

Watch out for

• It can delete drafts, and its agent can do more

  manage-draft can delete one or all drafts, and outside assistants must get your approval first. The ask_app tool hands work to the Mail agent, which can reach beyond the listed tools, so watch what you approve. github.com

• It reads your full inbox

  Email bodies and attachments go to whichever assistant you connect. Do not connect a mailbox with data that must stay private. github.com

• No read-only switch is documented

  The project documents no setting that removes the write tools. Decline write approvals if you only want to read. github.com