Connect an AI assistant (MCP)

Let an AI assistant search, read and draft your mail through MCP, and decide how it may send.

Updated

One Bit Mail runs an MCP server, so AI assistants that support MCP can work with your mail: search it, summarise conversations and draft replies in the mailboxes you choose. Nothing is sent without your approval.

Which assistants can connect

Assistants and coding tools that connect to a remote MCP server over HTTP with a bearer token. Signing in through OAuth from the assistant is not supported yet, so you create a token yourself and paste it into the assistant.

Connect an assistant

  1. Open Settings → API tokens.
  2. Under New personal token, choose Connect an AI assistant. This fills in a name and the usual scopes for an assistant: list mailboxes, read mail and write drafts.
  3. Choose the Mailboxes it may use. Fewer is safer.
  4. To let it send, add the Send mail scope, then decide how sends are approved (see below).
  5. Choose when it Expires after, then Create token and copy it. It is shown once.
  6. In your assistant's MCP settings, add https://app.onebitmail.com/mcp as a remote server, with the header Authorization: Bearer followed by your token.

What it can do

  • List your mailboxes, list and search conversations, and read them. Attachments are listed by name and size, not opened.
  • Create and change drafts. They appear in Drafts in the app.
  • Move a conversation to the Inbox, Archive, Trash or Spam, and mark it read or unread. Moving to Trash keeps it there for 30 days.

What it can't do

There are no tools to delete mail for good, empty Trash, set up forwarding, create filters or change any setting. Those stay with you in the app.

How sending is approved

An assistant can only send a draft, so the exact message exists in your Drafts first. Then one of two things happens:

  • Confirm in the conversation (the default). The assistant shows you a preview of the message and asks you to confirm. Only after you say yes does it send, with a one-time code that works for that exact message for 10 minutes. If the draft changes, the code stops working.
  • Approve in the app. Tick **AI assistants can't send on their own: each message waits until I press Send here** when you create the token. The assistant can then never send by itself: each message waits under Waiting for your approval in Settings → API tokens until you press Send.

The preview warns you when a message goes to someone never mailed from your workspace, to more than 5 people, uses Bcc, or replies into a new domain.

Admins can make approval in the app the rule for everyone: Settings → API tokens → Workspace (admins) → AI assistant sending → **Require approval in the app for every AI assistant send in this workspace**.

Limits

Messages from an assistant go through the same sending limits, reviews and checks as the app. Each assistant token can also send at most 20 messages an hour and 100 a day (half on the Free plan). See Sending limits.

Mail is treated as untrusted

Email is written by other people, and some of it tries to give instructions to AI assistants. So messages reach the assistant clearly marked as content from others, with hidden text removed, and the assistant is told never to follow instructions found in an email. Approving each send yourself is what keeps you in control.

Admin tokens and assistants

With an admin token, an assistant gets a read-only view of the workspace: users, shared mailboxes, domains and their DNS checks, and the plan's usage. It can't change any of them.

Stop an assistant

Revoke its token in Settings → API tokens. It stops working at once. See Use the API and webhooks.

Still need help?

Write to support@onebitmail.com. A person reads every message.