Disclaimer: This is an unofficial, community-built MCP server. It is not affiliated with, endorsed by, or supported by Purelymail.

---

What it does

Once installed, you can manage your Purelymail email infrastructure in plain language:

• "Add email for mycompany.com and set up all the DNS records"
• "Create a mailbox for hello@mycompany.com with a strong password"
• "Forward support@ to our team's inboxes"
• "Show me the DNS status for all my domains"

The agent handles the API calls. You describe the outcome.

---

Works great with mcp-server-cloudflare

Pair this server with the official mcp-server-cloudflare to let your agent handle the entire email setup end-to-end — DNS records and mailboxes — without you touching a single config panel.

Install both:

# Cloudflare MCP (official)
claude mcp add cloudflare --scope user -- npx mcp-server-cloudflare

# Purelymail MCP (this server)
claude mcp add purelymail \
  --scope user \
  -e PURELYMAIL_API_TOKEN=your-token-here \
  -- npx purelymail-mcp

Then just ask:

"I own acme.com on Cloudflare. Set up professional email for it on Purelymail."

The agent will: verify domain ownership → add MX, SPF, DKIM, and DMARC records to Cloudflare → register the domain on Purelymail → create your first mailbox. Done in minutes, zero copy-paste.

---

Prerequisites

• Node.js 18 or later
• Purelymail account — sign up at purelymail.com
• API token — generate one at purelymail.com/manage/account

---

Installation

Claude Code (recommended)

claude mcp add purelymail \
  --scope user \
  -e PURELYMAIL_API_TOKEN=your-token-here \
  -- npx purelymail-mcp

Replace your-token-here with your token from purelymail.com/manage/account.

From source

git clone https://github.com/zinxer/mcp-server-purelymail.git
cd mcp-server-purelymail
npm install

Then register it:

claude mcp add purelymail \
  --scope user \
  -e PURELYMAIL_API_TOKEN=your-token-here \
  -- node /absolute/path/to/mcp-server-purelymail/index.js

Other MCP clients

Add to your MCP client's server config:

{
  "mcpServers": {
    "purelymail": {
      "command": "npx",
      "args": ["mcp-server-purelymail"],
      "env": {
        "PURELYMAIL_API_TOKEN": "your-token-here"
      }
    }
  }
}

---

Tools

Deliverability

Tool	Description
check_deliverability	Run live DNS checks for a domain — MX, SPF, DKIM (all 3 keys), DMARC — with a scored report, issues list, and recommendations

Domains

Tool	Description
list_domains	List all domains with DNS validation status (MX, SPF, DKIM, DMARC)
get_ownership_code	Get the TXT record value needed to prove ownership of a new domain
add_domain	Add a domain once DNS records are in place
delete_domain	Delete a domain and all its associated mailboxes

Mailboxes

Tool	Description
create_user	Create a new email mailbox
list_users	List all mailboxes on the account
get_user	Get details for a specific mailbox
modify_user	Change password, recovery email, or settings
delete_user	Delete a mailbox

Routing

Tool	Description
list_routing_rules	List all routing and forwarding rules
create_routing_rule	Forward or alias an address to one or more inboxes
delete_routing_rule	Remove a routing rule

---

Example workflow

Prompt: "Add email for acme.com on Purelymail and set up the DNS in Cloudflare"

The agent will:

1. Call get_ownership_code → gets the exact TXT record value from the Purelymail API
2. Add TXT (ownership), MX, SPF, DKIM ×3, and DMARC records to Cloudflare
3. Call add_domain → registers acme.com once DNS passes

No copy-pasting. No looking up record values. No manual DNS entry.

---

Security

• Your API token is never stored in source code — it is passed via environment variable only
• The server runs locally on your machine; no data is proxied through any third party
• Treat your PURELYMAIL_API_TOKEN like a password — do not commit it to version control

---

Contributing

Issues and pull requests are welcome.

git clone https://github.com/zinxer/mcp-server-purelymail.git
cd mcp-server-purelymail
npm install
PURELYMAIL_API_TOKEN=your-token node index.js

Please open an issue before submitting large changes.

---

License

MIT — see LICENSE for details.

---

Disclaimer

This project was built by Matthew Prag as an open-source community tool. Purelymail is a trademark of its respective owners. This project is independently developed and is not affiliated with, endorsed by, or supported by Purelymail. The Purelymail name is used solely to describe compatibility with the Purelymail service.

For official Purelymail support, visit purelymail.com.