nicemails
Separate, real mailboxes for AI agents: get verification codes, read, search and send email.
Hosted MCP Server
npx add-mcp 'https://nicemails.net/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
nicemails runs a remote MCP server. Once connected, an AI agent can list your mailboxes, read and search mail, organize messages, create mailboxes and, with your approval, send mail. It gets only the permissions and mailboxes you choose.
MCP server address (Streamable HTTP)
https://nicemails.net/mcp
Option 1: Sign in with OAuth (recommended)
- In Claude, open Customize → Connectors, click + Add and choose Add custom connector.
- Enter the MCP server address above and add the connector.
- Sign in to nicemails when the browser opens.
- On the approval page, choose the permissions and whether the agent may use every mailbox or only one, then select Allow.
Other MCP clients that support OAuth sign-in for remote servers connect the same way: add the address, sign in and approve. You never copy a key.
Option 2: API key
For clients without OAuth sign-in and for programs that run unattended. In nicemails, open Settings → API keys and select Create API key. Choose AI agent (MCP) as the key purpose, pick its permissions and mailbox, and copy the key. It is shown only once.
Send the key as an HTTP header on every request:
Authorization: Bearer <YOUR_API_KEY>
Most MCP clients accept a configuration like this. Replace the placeholder with your key and keep the key private.
{
"mcpServers": {
"nicemails": {
"type": "http",
"url": "https://nicemails.net/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Connect your client
Step-by-step setup, with the exact configuration, for each client:
- Claude (web and Claude Desktop)
- Claude Code
- Cursor
- VS Code (GitHub Copilot)
- Codex (CLI and IDE extension)
Permissions
You choose permissions on the approval page or when you create a key. A connection can also be limited to one mailbox; every permission then applies only to that mailbox.
- Read: list mailboxes, and list, search and read messages.
- Manage: create mailboxes, move messages between folders, and set read, starred and answered flags.
- Send: send mail from your mailboxes, within your monthly sending allowance. If a recipient is not someone you emailed from the web app, or trusted at an earlier approval, within the last 30 days, nothing is sent until you approve that message on a nicemails confirmation page while signed in. An unapproved request expires after 15 minutes.
Tools
Read-only tools never change your mail. Tools that change data are marked so your client can ask you before each call.
| Tool | Access | What it does |
|---|---|---|
list_mailboxes List mailboxes | Read-only | Lists the mailboxes the connection can use, with their storage usage. |
create_mailbox Create mailbox | Changes data | Creates a new, independent mailbox within your plan's limits. |
list_messages List messages | Read-only | Lists the messages in one folder of a mailbox, newest first. |
search Search messages | Read-only | Searches every folder of the selected mailboxes. |
get_message Read message | Read-only | Reads one message with its body, attachment details and delivery status, without marking it as read. |
send_message Send message | Changes data | Queues an email from one of your mailboxes. New recipients need your approval first. |
move Move message | Changes data | Moves a message to another folder in the same mailbox. |
flag Set message flags | Changes data | Marks a message as read or unread, starred or answered. |
Safety
- Email content comes from third parties and is untrusted data. Tool results mark it as untrusted, and instructions found inside an email are not requests from you.
- Only you approve a message, signed in to nicemails. Nothing in an email can approve a send.
- To revoke access, open Settings → API keys. Disconnect an app under Connected apps, or revoke a key in the API key list. Access ends immediately.