Duobox MCP server
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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/mcpIt 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/mcpCursor. 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/mcpCodex. It lands in ~/.codex/config.toml.
codex mcp add duobox --url https://mcp.duobox.io/v1/mcpOther 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 |
| See the emails you receive. |
Save drafts |
| Leave them ready, without sending. |
Send mail |
| Send from your addresses. |
Manage the 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_messagewithautosends 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 |
|
| The inboxes your account can open. |
|
| Lists an inbox by folder, with search and filters by alias, date and thread owner. |
|
| Reads a whole email, with its thread, its attachments and, in a shared inbox, who has it. |
|
| How many emails are in Inbox, Drafts and Spam, and how many of the agent's proposals wait for your OK. |
|
| Downloads an attachment of up to 25 MB, with a link that expires in 10 minutes. |
Writing and sending
Tool | Scope | What it does |
|
| Saves a draft marked as the agent's, without sending it. |
|
| Writes an email or a reply. Unless told otherwise, it returns a preview and doesn't send. |
|
| Sends the preview exactly as it was shown, after you approved it. |
|
| Marks it read or unread, for everyone who shares the inbox. |
The shared inbox
Tool | Scope | What it does |
|
| Gives a thread an owner: the agent, a person in the inbox, or nobody. |
|
| Leaves a note for the team on the thread. The customer doesn't see it. |
Skills
Tool | Scope | What it does |
|
| Your skills: instructions that rewrite an email's body before it goes out. |
|
| Creates a skill: the tone, the language, the length, what always has to be said. |
|
| Edits a skill's instructions, its description, or whether it always applies. |
|
| Deletes a skill. Mail already sent with it doesn't change. |
Aliases and forwarding
Tool | Scope | What it does |
|
| The aliases that deliver into an inbox. |
|
| Adds an alias to the inbox, on its same domain. Up to five. |
|
| Removes an alias. The inbox stays. |
|
| An inbox's forwarding rules, and whether they are active yet. |
|
| Forwards what arrives: everything, mail from one sender, or mail sent to one address. An outside address stays pending until it confirms. |
|
| Removes a forwarding rule. |
The company, its people and its inboxes
Tool | Scope | What it does |
|
| The companies on your account. |
|
| Every inbox in the company and who opens it. |
|
| Creates an inbox, personal or shared. |
|
| Tries again an inbox that couldn't be created. |
|
| Tells support about an inbox that couldn't be created. |
|
| Deletes an inbox and its aliases. |
|
| The people in the company and their role. |
|
| The invitations not accepted yet. |
|
| Invites someone: they get an email with a link to pick their password. |
|
| Sends an invitation again. The previous link stops working. |
|
| Cancels an invitation not accepted yet. |
Your account and the plan
Tool | Scope | What it does |
|
| Your account: name, email and language. |
|
| The language of the emails we send you. |
|
| 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, |
Authentication | OAuth with PKCE. Dynamic client registration or Client ID Metadata Documents. |
Metadata |
|
Protocol | The 2026 version, and |
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
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.
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Related MCP Servers
- AlicenseAqualityBmaintenanceHosted 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.2314AGPL 3.0
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmISC
- AlicenseNot gradedqualityCmaintenanceGives 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
- AlicenseNot gradedqualityBmaintenanceEnables 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