Skip to main content
Glama
Duobox MCP server

Duobox MCP server

Official
by duoboxio

Duobox MCP server

The official MCP server for Duobox, business email on your own domain. Connect ChatGPT, Claude, Cursor or any MCP client to your company email: your agent reads mail, writes and sends it, and manages the team, with the permissions you choose.

https://mcp.duobox.io/v1/mcp

It is a hosted server. There is nothing to install and there is no API key: the agent signs in over OAuth with a Duobox mail account, the same address and password you open your inbox with.

Full page: duobox.io/en/mcp

Connect it

When the client asks you to sign in, use your Duobox mail account.

Claude. Open Customize, then Connectors, and add a connector. Paste the address. Leave sign-in on so it asks for your account.

ChatGPT. Open Plugins and add an MCP server. Paste the address and choose OAuth.

Claude Code. Run this in the project folder. It lands in .mcp.json.

claude mcp add --transport http duobox https://mcp.duobox.io/v1/mcp

Cursor. Open Settings, then MCP, and add a server. Or paste this into .cursor/mcp.json:

{
  "mcpServers": {
    "duobox": {
      "url": "https://mcp.duobox.io/v1/mcp"
    }
  }
}

VS Code. In the command palette, MCP: Add Server. Or paste this into .vscode/mcp.json:

{
  "servers": {
    "duobox": {
      "type": "http",
      "url": "https://mcp.duobox.io/v1/mcp"
    }
  }
}

Windsurf. In Cascade, open Manage MCPs. Or paste this into ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "duobox": {
      "serverUrl": "https://mcp.duobox.io/v1/mcp"
    }
  }
}

Gemini CLI. It lands in ~/.gemini/settings.json.

gemini mcp add --transport http duobox https://mcp.duobox.io/v1/mcp

Codex. It lands in ~/.codex/config.toml.

codex mcp add duobox --url https://mcp.duobox.io/v1/mcp

Other clients. If it asks for an address, paste the server's. If it asks for a file, use the Cursor one. If it asks for the type, it's http.

The same steps are in Duobox mail, under Settings → MCP.

Related MCP server: Email MCP Server

Permissions

When you connect a client, Duobox shows what it asks for. Everything starts checked: take off what you don't want.

Permission

Scope

What it allows

Read your mail

mail:read

See the emails you receive.

Save drafts

mail:draft

Leave them ready, without sending.

Send mail

mail:send

Send from your addresses.

Manage the company

company

The team, the plan and the inboxes.

  • Sending mail includes saving drafts, and saving drafts includes reading.

  • If a tool needs a permission you took off, the client is asked for it again.

  • Manage the company doesn't replace your role: if you don't administer the company, those tools answer no.

  • In Duobox mail, Agents → Connections lists every connected app, since when, and the last time it came in. Cut off access shuts it out right away.

The agent proposes, you send

send_message doesn't send by default: it leaves the email as the agent's draft and returns the preview, exactly as it would go out. confirm_message sends it untouched.

  • If you asked the agent not to check with you, send_message with auto sends it in the same step.

  • Each inbox decides whether the agent can send on its own: Send without your OK, under Settings → MCP. On new inboxes it starts off, and the proposal waits for a person to send it.

  • What the agent proposes sits in Drafts, marked Waiting for your OK. What it did is in Agents → Activity.

Tools

35 tools, grouped by task. Each one carries the MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) so the client can decide when to ask you.

Reading mail

Tool

Scope

What it does

list_my_mailboxes

mail:read

The inboxes your account can open.

list_messages

mail:read

Lists an inbox by folder, with search and filters by alias, date and thread owner.

get_message

mail:read

Reads a whole email, with its thread, its attachments and, in a shared inbox, who has it.

get_folder_counts

mail:read

How many emails are in Inbox, Drafts and Spam, and how many of the agent's proposals wait for your OK.

download_attachment

mail:read

Downloads an attachment of up to 25 MB, with a link that expires in 10 minutes.

Writing and sending

Tool

Scope

What it does

save_draft

mail:draft

Saves a draft marked as the agent's, without sending it.

send_message

mail:send

Writes an email or a reply. Unless told otherwise, it returns a preview and doesn't send.

confirm_message

mail:send

Sends the preview exactly as it was shown, after you approved it.

mark_message

mail:draft

Marks it read or unread, for everyone who shares the inbox.

The shared inbox

Tool

Scope

What it does

assign_thread

mail:draft

Gives a thread an owner: the agent, a person in the inbox, or nobody.

add_note

mail:draft

Leaves a note for the team on the thread. The customer doesn't see it.

Skills

Tool

Scope

What it does

list_skills

mail:read

Your skills: instructions that rewrite an email's body before it goes out.

create_skill

mail:draft

Creates a skill: the tone, the language, the length, what always has to be said.

update_skill

mail:draft

Edits a skill's instructions, its description, or whether it always applies.

delete_skill

mail:draft

Deletes a skill. Mail already sent with it doesn't change.

Aliases and forwarding

Tool

Scope

What it does

list_aliases

mail:read

The aliases that deliver into an inbox.

create_alias

mail:draft

Adds an alias to the inbox, on its same domain. Up to five.

delete_alias

mail:draft

Removes an alias. The inbox stays.

get_forward

mail:read

An inbox's forwarding rules, and whether they are active yet.

set_forward

mail:send

Forwards what arrives: everything, mail from one sender, or mail sent to one address. An outside address stays pending until it confirms.

delete_forward

mail:send

Removes a forwarding rule.

The company, its people and its inboxes

Tool

Scope

What it does

list_organizations

mail:read

The companies on your account.

list_organization_mailboxes

company

Every inbox in the company and who opens it.

create_mailbox

company

Creates an inbox, personal or shared.

retry_mailbox

company

Tries again an inbox that couldn't be created.

report_mailbox

company

Tells support about an inbox that couldn't be created.

delete_mailbox

company

Deletes an inbox and its aliases.

list_members

company

The people in the company and their role.

list_invitations

company

The invitations not accepted yet.

create_invitation

company

Invites someone: they get an email with a link to pick their password.

resend_invitation

company

Sends an invitation again. The previous link stops working.

delete_invitation

company

Cancels an invitation not accepted yet.

Your account and the plan

Tool

Scope

What it does

get_me

mail:read

Your account: name, email and language.

set_locale

mail:read

The language of the emails we send you.

get_entitlements

company

How many people, domains and inboxes the plan allows, and how many are used.

The server also publishes four prompts with the step by step of each task (mail, addresses, team and account) and ready examples, like summarizing what's unread or replying to an email.

For developers

Transport

Streamable HTTP, POST /v1/mcp

Authentication

OAuth with PKCE. Dynamic client registration or Client ID Metadata Documents.

Metadata

https://mcp.duobox.io/.well-known/oauth-protected-resource

Protocol

The 2026 version, and 2025-11-25 too.

Registry

io.duobox/mail in the official MCP registry

This repository holds the server's public listing (server.json, .mcp.json) and its docs. The server itself runs on Duobox's infrastructure.

You need a Duobox account

The agent signs in with a mail account. The account is born at duobox.io: you create the company, turn on mail for your domain and create your address.

Help

Something not working? Write to hola@duobox.io. Security reports: see SECURITY.md.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • Your agent needs a mailbox of its own — to receive, thread, draft and send, with attachments, without borrowing your personal inbox or your company's SMTP. **What you can ask for** • "Create an inbox for this agent and tell me its address." • "Read the new messages in this thread and draft a reply." • "Send this message with the attachment and wait for the response." • "Search this inbox for everything from that domain." • "Show delivery metrics and the events on this inbox." **How to use it** Point any MCP client at https://mcp.aisa.one/mail/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: create and delete inboxes, list and read messages, raw message bodies, attachments, threads, drafts and draft attachments, send and reply, message search, inbox events, metrics, and list entries — reads and writes. **Why this rather than the source** A real inbox an agent owns, rather than an SMTP credential it borrows from a human. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the contact elsewhere in the catalogue, then write to them from here — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp finds the person to write to.

    • Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.

      https://www.primitive.dev/mcp
    • Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys

      https://api.agenticemail.dev/mcp
    • Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.

      https://mcp.agentmail.to/mcp

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Hosted email for AI agents. Connect Gmail, Outlook / Microsoft 365 or any IMAP mailbox to Claude, ChatGPT, Cursor and other MCP clients, then read, search, send, organize, draft, schedule and auto-triage mail. Email is fetched live and never stored. Free for 1 inbox.
      23
      14
      AGPL 3.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to read, search, send, manage, schedule, and analyze email across multiple IMAP/SMTP accounts through a single MCP server. Also supports drafts and templates, provider-aware labels and bulk operations, calendar extraction, real-time mailbox watching, and OAuth2 sign-in for Gmail and Microsoft 365.
      31 npm
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI agents a real email inbox on the user's own domain, letting them read and search mail, draft and send or schedule replies, file messages, create addresses, and fix DNS records. Access is scoped to only the mailboxes the user explicitly grants.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to work with existing IMAP/SMTP mailboxes through a native MCP endpoint, with granular token scopes for reading, searching, organizing, drafting, sending, and managing folders plus optional AI-assisted summaries and replies. Drafts are saved to real IMAP Drafts folders, and permissions are enforced by the shared mail engine.
      AGPL 3.0