Connect an AI agent

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 Settings → Connectors 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>"
      }
    }
  }
}

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.

REST API reference