Command Mail MCP server
Commit Oct 28, 2026Allows an AI agent to read, search, sort, draft, and send emails across multiple addresses through a unified inbox.
Also known as FYN-Labs/commandmail-plugin, commandmail-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 28, 2026
- License
- MIT
What is Command Mail MCP?
Command Mail allows an AI agent to read, search, sort, draft, and send emails across multiple addresses through a unified inbox.
Summary generated from the project's README
About Command Mail MCP server
Managing multiple email accounts through a single interface is what Command Mail enables for AI agents. Developers and users can connect their agent hosts to a remote MCP server to allow an AI to read, search, sort, draft, and send messages. The system uses OAuth 2.1 with PKCE for authentication, meaning you sign in via a browser and never share your actual passwords or API keys with the agent.
Functionality depends on your chosen plan. The Free plan allows for one mailbox with 90 days of history for reading, searching, and drafting, but it does not permit sending. The Pro plan expands this to ten mailboxes and includes full mail history along with the ability to send replies and forwards. You can control exactly what the agent does through specific permissions like mail:read, mail:draft, and mail:send-approved, ensuring the AI only performs actions within your defined autonomy levels.
What you can do with it
- 1Automate daily email managementAsk your agent to set up a recurring routine to check new mail and prepare a morning brief.
- 2Organize a cluttered inboxHave the agent perform an inbox cleanup by sorting messages and creating new rules based on your corrections.
- 3Draft and manage correspondenceUse the agent to find specific emails and create formatted drafts or attachments for your review.
Written from the project's README. Every use case is checked against a quote from it.
How to install Command Mail MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Command Mail MCP in Claude Code
$ claude mcp add --transport http commandmail-plugin https://commandmail.app/mcpInstall Command Mail MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"commandmail-plugin": {
"url": "https://commandmail.app/mcp"
}
}
}Install Command Mail MCP in VS Code
.vscode/mcp.json
{
"servers": {
"commandmail-plugin": {
"type": "http",
"url": "https://commandmail.app/mcp"
}
}
}Install Command Mail MCP in VS Code CLI
$ code --add-mcp '{"name":"commandmail-plugin","type":"http","url":"https://commandmail.app/mcp"}'Install Command Mail MCP in Codex
$ codex mcp add commandmail-plugin --url https://commandmail.app/mcpInstall Command Mail MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.commandmail-plugin] url = "https://commandmail.app/mcp"
Install Command Mail MCP in Gemini CLI
$ gemini mcp add -s user --transport http commandmail-plugin https://commandmail.app/mcpInstall Command Mail MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"commandmail-plugin": {
"url": "https://commandmail.app/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablefyn-labs/commandmail-plugin is public and reachablegithub.com/fyn-labs/commandmail-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-28github.com/fyn-labs/commandmail-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubCommand Mail plugin
Command Mail is one inbox for all of your email addresses, built so your AI agent can work in it. The agent reads, searches, sorts and drafts, and sends only if you allow it, per permission and per mailbox.
This repository connects agent hosts to the hosted Command Mail MCP server at https://commandmail.app/mcp and adds four skills. You need a Command Mail account; start for free with one address.
Plans
The plugin and the MCP connector are free and released under the MIT License. Installing and using them costs nothing.
The hosted Command Mail service has a Free plan that does not expire: one mailbox, the last 90 days of mail, reading, search, sorting, the morning brief and drafts. On the Free plan the agent cannot send email.
The paid Pro plan adds sending, up to ten mailboxes and the full mail history. Plans are bought only on commandmail.app, never inside an agent host or editor; current prices are listed there. Without a paid plan, the agent can still read, search, sort and draft; actions that send mail, such as replies and forwards, need Pro.
Skills
| Skill | Use it to |
|---|---|
inbox-setup |
Set up a new account with you: priorities, autonomy, archive folders, sorting rules, Spam and Trash retention, signature and a recurring routine your agent host schedules |
inbox-routine |
Run one mail pass: check new mail since the last complete run, presort it with your rules, prepare drafts, record the run and write a short brief |
inbox-cleanup |
Clean up a large inbox in agreed passes: the agent sorts, you correct, the agent moves the mail and creates the agreed rules |
mail-workflow |
Find and read mail, answer with plain or formatted drafts and attachments, file conversations, manage folders and track follow-ups |
Ask your agent, for example, "Set up my inbox and a daily mail routine" or "Run my Command Mail routine". A routine runs on a schedule only if your agent host supports scheduled tasks and you created one.
The server is also listed in the Official MCP Registry as app.commandmail/mail.
Install
ChatGPT and Codex. Command Mail will appear in the ChatGPT and Codex plugin directory once it is listed there. Until then, add this repository as a marketplace in Codex:
codex plugin marketplace add FYN-Labs/commandmail-plugin
codex plugin add command-mail@commandmail
Claude Code.
/plugin marketplace add FYN-Labs/commandmail-plugin
/plugin install command-mail@commandmail
Cursor. Once the plugin is listed in the Cursor Marketplace, install it from Customize. To try it before that, clone the repository into your local plugin folder and run Developer: Reload Window:
git clone https://github.com/FYN-Labs/commandmail-plugin ~/.cursor/plugins/local/command-mail
The MCP server then appears as plugin-command-mail-commandmail. Cursor opens the Command Mail sign-in on first use; the plugin needs no API key or variable.
Gemini CLI.
gemini extensions install https://github.com/FYN-Labs/commandmail-plugin
Any other MCP client. Add a remote MCP server with the Streamable HTTP transport and the URL https://commandmail.app/mcp.
Sign in
On first use, your agent opens Command Mail in the browser. Sign in and switch on the permissions you want to grant; sending without your approval starts switched off. The connection uses OAuth 2.1 with PKCE, so you never give the agent a password or API key. You can disconnect an agent at any time under Settings → Connections.
Permissions
| Permission | What the agent may do |
|---|---|
mail:read |
Read, search and sort mail, manage folders and the sorting rules you ask for, prepare the overview and morning brief, track follow-ups |
mail:draft |
Create and revise drafts; never sends |
mail:send-approved |
Send exactly the draft revision you approved |
mail:send |
Send without approval, once per message, to at most 20 recipients and within a daily limit |
mailboxes |
Connect addresses, verify domains, import old mail |
Each mailbox also has an autonomy level (read, suggest, rules or auto) that limits what an agent may change. Email content is treated as data, never as instructions.
Network and credentials
The plugin ships no executable code, hooks or install scripts. It declares one remote MCP server, https://commandmail.app/mcp, and the agent host talks only to commandmail.app: the MCP endpoint and the OAuth endpoints it advertises under /.well-known/. The only credential is the OAuth token your agent host receives after you sign in; you never enter a password or API key into the plugin.
Package layout
| Host | Files |
|---|---|
| ChatGPT, Codex, Cursor (Agent Plugins) | plugin.json, mcp.json |
| Cursor Marketplace (logo and listing) | .cursor-plugin/plugin.json |
| Claude Code | .claude-plugin/, .mcp.json |
| Gemini CLI | gemini-extension.json |
| All hosts | skills/, assets/ |
plugin.json also carries the listing, review cases and release notes for the OpenAI plugin directory under extensions.com.openai. Build the upload ZIP with scripts/build-openai-zip.sh /path/to/commandmail-plugin.zip; it contains only the portable package. Reviewer credentials never belong in this repository.
Legal and support
Command Mail is operated by FYN Labs LLC. This plugin is released under the MIT License.
Command Mail MCP questions
How do I add Command Mail MCP to Claude Code?
Run claude mcp add --transport http commandmail-plugin https://commandmail.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Command Mail MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is the difference between the Free and Pro plans?
The Free plan includes one mailbox with 90 days of history and allows reading, searching, and drafting, but prevents the agent from sending mail. The Pro plan adds sending capabilities, up to ten mailboxes, and full mail history.
How do I sign in and secure my account?
You sign in via your browser using OAuth 2.1 with PKCE, meaning you never have to provide your password or an API key to the agent.
Can the agent send emails without my permission?
By default, sending is switched off; you can grant specific permissions for the agent to send approved drafts or send without approval within certain limits.