Give Claude Code its own email address

Claude Code can work from a real inbox: search threads, read incoming mail, save reply drafts and send once you approve the final text. Mailly gives it an address such as your-name@mailly.site (or one on your own domain) and connects over Remote MCP, so nothing runs on your machine.

What you getCopy Anchor Link

• A two-way inbox on @mailly.site, or on your own domain on the Developer plan.
• About 70 typed MCP tools for threads, drafts, sending, domains, contacts, templates, campaigns and workflows, limited to the permissions you grant.
• Sending under your control: Claude Code shows the exact text and recipients, and sends only after you confirm.
• The same inbox in the Mailly workspace, the CLI and the HTTP API.

Read https://mailly.site/auth.md
and set up a Mailly inbox for me over HTTP.
Ask me for the name if unknown; if taken, ask for another,
with no blind retries.
Send me the verification link.
After I confirm the inbox in my browser,
store the API key securely, tell me the address,
and ask me before sending any email.

claude mcp add --transport http --scope user mailly https://mcp.mailly.site/mcp

Share the server with a projectCopy Anchor Link

claude mcp add --scope project writes this to .mcp.json. You can also commit it by hand; each teammate signs in with their own Mailly account through /mcp.

{
  "mcpServers": {
    "mailly": {
      "type": "http",
      "url": "https://mcp.mailly.site/mcp"
    }
  }
}

Headless runsCopy Anchor Link

claude -p and Agent SDK runs can't complete OAuth. Sign in once from an interactive session (/mcp) or with claude mcp login mailly; Claude Code stores and refreshes the tokens. For CI, you can send your Mailly API key as a header instead. Claude Code expands ${VAR} in .mcp.json headers:

{
  "mcpServers": {
    "mailly": {
      "type": "http",
      "url": "https://mcp.mailly.site/mcp",
      "headers": { "Authorization": "Bearer ${MAILLY_API_KEY}" }
    }
  }
}

Verify the connectionCopy Anchor Link

1. Run claude mcp list. The mailly entry should show ✔ Connected.
2. Ask Claude Code: "Use Mailly to list my inbox addresses and my five most recent threads." It should call mailly_list_inbox_addresses and mailly_list_threads.
3. Send an email from your personal account to your Mailly address, then ask: "Read my latest Mailly thread and save a reply draft. Show me the exact text and don't send it." Claude Code calls mailly_read_thread and mailly_save_draft. Approve or discard the draft in the conversation.

Use the CLI insteadCopy Anchor Link

Claude Code can also drive mailly-cli through its shell. Every command accepts --json, which suits agents.

npm install -g mailly-cli   # Node.js 18+
mailly login                # browser sign-in; --no-browser on remote machines
mailly inbox addresses list --json
mailly inbox threads list --json

TroubleshootingCopy Anchor Link

• ! Needs authentication: run /mcp and authenticate, or run claude mcp login mailly.
• ✘ Failed to connect with an Authorization header: Claude Code reports a rejected key as a failed connection. Check the key, or remove the header to use OAuth. claude mcp get mailly shows an Issue: line with the HTTP status.
• A tool you expected is missing: it needs a permission you didn't grant. In /mcp, choose Clear authentication, then authenticate again and grant the permission. Mailly never widens an existing grant on its own.
• The browser redirect fails after sign-in: paste the full callback URL from the address bar into the prompt in Claude Code.
• No mail arrives: check the address in the workspace and look in the inbox's Spam folder.
• A send is refused: check your balance and limits with mailly_account. The Free plan allows 100 send recipients per rolling 24 hours; see pricing.

To remove Mailly, run claude mcp remove mailly; Claude Code also deletes the stored tokens.