How to Use Bytemail: The Beginner’s Guide to the Mac Email App Your AI Agents Can Drive

CodexFuse Team · 2026-11-03T02:30:12.916Z · 13 min read min read

Bytemail is the native Mac email app with a built-in Email MCP server: 27 tools that let Claude Code, Codex, Cursor and other agents search every inbox, draft replies and tidy your folders while every send waits for your approval. This beginner’s guide covers setup, per-client connect commands, the safety rules and the 7 mistakes to avoid.

Bytemail is a native Mac email app that puts a built-in Email MCP server on your computer, so an AI coding agent like Claude Code, Codex or Cursor can search every inbox, draft replies and tidy your folders without your mail ever passing through a third-party cloud. This is a different animal from a classic speed client like Superhuman: instead of shortcuts for you, Bytemail gives your agent 27 tools and keeps the final say with you. In this guide you will add your first inbox, switch on the MCP server, wire it to your agent, and learn the safety rules before anything sends on its own.

What Is Bytemail, Exactly?

Bytemail is a native Mac email app built in Swift that combines Gmail, iCloud, Outlook, Microsoft 365, Yahoo, Fastmail and any IMAP server in one window. It runs only on macOS 14 or later, connects your Mac straight to your mail provider with no bytemail relay in the middle, and its signature feature is a built-in MCP server: any AI app on your Mac that speaks the Model Context Protocol can search, read, draft and tidy your mail through it.

The app launched publicly on Product Hunt on October 21, 2026, where its maker Sergey described it as the truly native Mac client he could not find: no Electron wrapper, no routing mail through someone else's servers, and a mail-in-the-notch interface with widgets for the desktop. A one-time clarification: Bytemail is not BitMail (a 2013 peer-to-peer encrypted email client) and not ByMail (a Python library for temporary email) — different products, different names.

Why the MCP Server Is the Point of Bytemail

The MCP server is the reason this app exists alongside Apple Mail: it turns your inbox into something an agent can work with, while the mail itself stays on your Mac. When you ask your agent "find last week's invoice from the accountant", it calls Bytemail's tools directly, and what you get back is an answer built from your actual mail, not from a cloud connector you signed up for separately.

Bytemail's server is local and multi-account: it works across every account you already have in the app at once, using the sign-ins you already completed. Typical email MCPs or connectors cover one provider at a time from someone's cloud; Bytemail's covers all of yours from your own machine.

If you want the bigger picture on what MCP servers unlock for agents, our Dify beginner guide walks through the agent-tool ecosystem. The local twist matters here: Bytemail hands your messages to the AI marked as other people's words and tells it never to follow instructions found inside them — a deliberate answer to the "email as prompt injection" problem.

How Do You Add Your First Inbox?

You add an account exactly once per provider, in the app, and the MCP server reuses that work — no second sign-in for the agent. Bytemail's own setup guide was last tested by its team in October 2026, and the flow below follows it.

1. Open Bytemail and start a new account. On first launch it asks you to add an account. If you already have one connected, open the account settings and add another.
2. Pick Gmail (or your provider) from the list. Bytemail covers Gmail, iCloud, Outlook, Microsoft 365, Yahoo, Fastmail and any IMAP server.
3. Sign in on Google's page in the browser window that opens. Your default browser opens a standard Google sign-in page — you type your password on Google's own page, not into the app. With 2-Step Verification on, approve the phone prompt after the password.
4. Review the permissions Google asks you to approve. Read the consent screen before clicking through; you can review or revoke the app's access later from your Google Account settings.
5. Let the initial mailbox sync finish. Folders appear first, then messages fill in. Leave the app open. To confirm, check your inbox shows recent mail, send yourself a test email, and reply to it.

Your credentials live in the macOS Keychain, and no bytemail server sits between your Mac and Google. If sign-in stalls with a "Couldn't sign you in" message, check your connection and confirm you picked the right Google account; a Google 400 error during sign-in usually clears by switching the default browser or restarting the Mac.

What the 27 Tools Actually Do

The 27 tools ship in every plan, trial included — reading is not a free tier and writing a paid one. They fall into three groups, and you address all of them in plain words; only developers need the tool names on the right.

That inventory is the practical answer to "what can I ask it to do": anything from "draft a reply to this thread" to "snooze everything from the newsletter sender and unsubscribe me from the list". The big changes — send, send later, a new rule, removing a label, unsubscribe, block — always wait for your explicit say-so in Bytemail itself, not in the AI app.

How Do You Connect Claude, Codex, Gemini CLI or Cursor?

The setup takes a minute or two and has three moves: turn the server on, connect your AI app, ask. Nothing in step 2 works until step 1 is done, and the MCP server stays off until you switch it on yourself.

1. Turn it on. In Bytemail, open Settings > AI, switch on Turn on bytemail MCP and choose which accounts to share. You can share your work account and keep your personal one private.
2. Connect your AI app. Pick your client below. The same Settings > AI pane shows each command with the right path for your copy of Bytemail filled in.
3. Ask. Your AI app now talks to Bytemail's MCP server on your Mac, and every change it makes shows up in Bytemail as if you had made it — with Undo.

claude mcp add --scope user bytemail -- \
  /Applications/ByteMail.app/Contents/MacOS/ByteMail --mcp

codex mcp add bytemail -- \
  /Applications/ByteMail.app/Contents/MacOS/ByteMail --mcp

gemini mcp add --scope user bytemail \
  /Applications/ByteMail.app/Contents/MacOS/ByteMail -- --mcp

{
  "mcpServers": {
    "bytemail": {
      "command": "/Applications/ByteMail.app/Contents/MacOS/ByteMail",
      "args": ["--mcp"]
    }
  }
}

New to Claude Code itself? Our Claude Code beginner guide covers the install and your first session. One honest boundary, stated by the vendor: ChatGPT itself only connects to MCP servers on the internet, so it cannot reach Bytemail's local server on your Mac.

Can the Agent Send Mail Without You?

No — not unless you say so. Every send asks you in Bytemail first; the only exception is addresses you chose to trust for that session. The safety model is built around four guarantees, and you should know them before you connect anything.

Two details beginners miss: searching and reading work any time, but changes like drafts and archiving are carried out by the Bytemail app, so they wait until it is open — and the AI app is told so. And what an AI app reads goes to that app, and to its provider if the model runs in the cloud.

How Do You Keep Everything on Your Mac?

Run a local model and nothing leaves your Mac at all. Bytemail's AI settings let you point its own summaries and reply ideas at a model you choose — Claude, OpenAI or OpenRouter with your own API key, or LM Studio or Ollama running on your machine.

That is the honest version of "private by default": your mail never touches Bytemail's servers either way, and with a local model your words never touch a cloud model provider either. If you run local models already, our Ollama beginner guide gets one running in minutes.

Bytemail vs Superhuman: Which One Is Yours?

These two are not rivals — they are answers to different questions. Superhuman owns the classic speed-client lane: you drive the inbox faster with shortcuts and triage muscle. Bytemail is the agent-controlled inbox: the AI does the driving and you approve. One line per row:

Pick the speed client if your inbox is a reflex sport; pick Bytemail if you want to stop doing email at all and review instead. Many people will reasonably use both for different moods.

What Does Bytemail Cost?

Bytemail is a paid app with three shapes: monthly, yearly, or a one-time lifetime licence — and the MCP server is included in every plan, free trial included, with all 27 tools, not just reading. The vendor's MCP page currently advertises a 7-day free trial, then $3.99 a month or pay once and keep it.

One caution, straight from the vendor's own pricing page (last checked October 13, 2026): it deliberately prints no dollar figures and tells you to confirm amounts on the purchase screen in the app, because prices can change. Trust the purchase screen over anything you read here.

7 Beginner Mistakes to Avoid

Most early frustration with Bytemail comes from setup assumptions, not from the app. Learn from the vendor's troubleshooting notes and its testers' reports:

What Should You Ask Your Agent First?

Start with low-stakes prompts that teach you the tool boundaries before you trust it with anything that sends. Five first prompts, in order of risk:

1. "Search every account for the invoice from last week and show me the amounts." Read-only, exercises search_messages and find_attachments.
2. "Summarize the long thread about the Q4 plan into five bullets." Read-only, exercises get_thread.
3. "Draft a polite decline to this thread and leave it as a draft." Writes a draft you review — nothing sends.
4. "Snooze all newsletters until Monday morning." A reversible tidy-up; check Settings > AI > Activity and use Undo if it overreaches.
5. "Add a rule that labels receipts and archives them." The first action that asks you in Bytemail before it is created — approve it there.

Bytemail is a CodexFuse blog subject, not a CodexFuse product — we publish guides like this one; we do not sell or build a Bytemail client. Everything above describes the vendor's app on your Mac.

Sources

• bytemail — Email MCP server for every inbox: Claude, Codex & Cursor (bytemailapp.com/mcp) — 27 tools, connect commands, safety rules, pricing note
• bytemail Pricing 2026: Plans, Cost & What's Included (bytemailapp.com/pricing) — plan shapes, "confirm on the purchase screen" stance, prices last checked October 13, 2026
• How to Add a Gmail Account to Mac (2026 Steps) (bytemailapp.com/blog/add-gmail-mac) — 5-step Gmail flow, troubleshooting table; last tested October 2026
• bytemail — Product Hunt launch page (producthunt.com/products/bytemail) — launched 2026-10-21; maker Sergey's description; 7-day trial, monthly/yearly/lifetime, iPhone TestFlight beta
• Gmail App for Mac: Native, Fast, No Relay (bytemailapp.com/features/gmail-mac) — native Swift, macOS 14+, Apple silicon, no relay, network-connection list published

Frequently Asked Questions

Is Bytemail free?

Not as a permanent plan — it is a paid app with monthly, yearly and lifetime options. There is a free trial (the vendor's MCP page advertises 7 days), and the MCP server with all 27 tools is included in every plan, trial included.

Can Bytemail's AI delete my mail?

No. AI apps can archive, move, mark, flag, snooze and mute — never delete, and never touch Spam or Trash. Removing a label moves mail back to your inbox; only if you ask does it go to Trash, where you can restore it.

Can ChatGPT use Bytemail's MCP server?

No. ChatGPT only connects to MCP servers on the internet, and Bytemail's server runs locally on your Mac, so it cannot reach it. Claude, Claude Code, Codex, Gemini CLI, Cursor, LM Studio and other local MCP apps can.

Does Bytemail work on iPhone or Windows?

No. Bytemail is a native Swift app for macOS 14 and later only. An iPhone companion app is in public beta on TestFlight, and there is no Windows or Android client.

How is Bytemail different from Superhuman?

Superhuman is a classic speed client that makes you faster at email with shortcuts and triage flows; Bytemail is the agent-controlled inbox, where your AI agent does the reading, drafting and tidying through 27 MCP tools while every send still waits for your approval in Bytemail.