Docs

Plainmail has a remote MCP server, so Claude and other AI agents can set up domains and mailboxes and read and send your mail. You sign in with your Plainmail account and choose what the agent may do.

Server URL

https://app.plainmail.dev/api/mcp/mcp

You need a Plainmail account with an active subscription.

Claude (web and desktop)

Open Settings, then Connectors, and choose Add custom connector.
Name it Plainmail and paste the server URL.
Choose Connect, sign in to Plainmail, check the permissions you want and choose Allow.

Claude Code

claude mcp add --transport http plainmail https://app.plainmail.dev/api/mcp/mcp

Then run /mcp, pick plainmail and sign in in the browser window that opens.

Other MCP clients

Cursor, VS Code and other clients that support remote MCP servers with OAuth connect with the same URL. For a client without OAuth, create an API key in Settings and send it as a header: Authorization: Bearer <key>.

Permissions

When you connect, Plainmail asks which of these to allow. You can allow some and not others.

Read mail: list and read messages and attachments.
Send and organize mail: send and reply, mark messages read or flagged, move them.
Manage domains, mailboxes and billing: add and remove domains, mailboxes and aliases.

To disconnect an app, open Settings, find it under Connected apps and choose Revoke. It loses access right away.

Things to ask

Set up hello@mynewapp.com on Plainmail
Is the DNS for mynewapp.com healthy?
Summarize what came into support@mynewapp.com today
Reply to the latest message from Maya and say the annual plan is $50

Tools

Tool	What it does	Effect
`add_domain`	Adds a domain and writes its mail records at your DNS host, or returns the records to copy	Changes
`check_domain`	Checks a domain's MX, SPF, DKIM and DMARC records	Reads
`list_domains`	Lists your domains and their status	Reads
`delete_domain`	Removes a domain and its mailboxes	Deletes
`connect_dns_provider`	Returns a link where you connect Cloudflare, Vercel or Porkbun	Reads
`create_mailbox`	Creates a mailbox and returns a one-time link that shows its password	Changes
`list_mailboxes`	Lists your mailboxes	Reads
`delete_mailbox`	Deletes a mailbox and its mail	Deletes
`reset_password`	Replaces a mailbox password; the old one stops working	Deletes
`add_alias`	Adds another address that delivers to a mailbox	Changes
`remove_alias`	Removes an alias	Deletes
`set_sender_name`	Sets the name shown on mail you send	Changes
`list_messages`	Lists messages in a folder	Reads
`read_message`	Reads one message without marking it read	Reads
`send_message`	Sends or replies from one of your addresses	Changes
`update_message`	Marks messages read or flagged, or moves them	Changes
`get_attachment`	Returns a download link for an attachment, valid 10 minutes	Reads

Safety

Mailbox passwords never pass through the agent: a new mailbox comes with a link that shows its password once, to you. Email content is labeled untrusted in every tool result, and the server tells the agent never to follow instructions found inside an email.

Help

Email support@plainmail.dev. A person reads every message.