MailPace — Claude Code MCP server: email and setup
The MCP server for Claude Code sends transactional email and manages MailPace domains. It can also retrieve delivery, bounce, and deferral status.
MIT ★ 1 updated 2026-11-10
claude mcp add --env MAILPACE_API_TOKEN=<MAILPACE_API_TOKEN> --env MAILPACE_ORGANIZATION_TOKEN=<MAILPACE_ORGANIZATION_TOKEN> --env MAILPACE_ALLOWED_RECIPIENTS=<MAILPACE_ALLOWED_RECIPIENTS> --env MAILPACE_REQUEST_TIMEOUT_MS=<MAILPACE_REQUEST_TIMEOUT_MS> --env MAILPACE_MAX_RETRIES=<MAILPACE_MAX_RETRIES> --transport stdio mailpace -- npx -y @mailpace/mcpWhat MailPace does
MailPace gives an agent tools to send email and manage MailPace domains and tokens. It can create or edit a sending domain, inspect its DKIM DNS records, and retrieve an email's status using its ID and domain.
Running the server requires Node.js 20 or later, a MailPace organization, and a domain. A domain API token is needed for sending and status checks; an organization API token is needed for domain and token management. Credentials come from environment variables. Automated sending can be limited to approved recipients with MAILPACE_ALLOWED_RECIPIENTS.
What it helps with
- send a transactional email from an agent
- check whether an email was delivered, bounced, or deferred
- create a sending domain and inspect its DNS records
- create or revoke a domain API token
Example prompts for the agent
- Send a transactional email to the address in the task.
- Check the status of email
email-idfor domainexample.com. - List my MailPace domains and verify DNS records for
example.com.
How to install MailPace
Platform CLI
claude mcp add --env MAILPACE_API_TOKEN=<MAILPACE_API_TOKEN> --env MAILPACE_ORGANIZATION_TOKEN=<MAILPACE_ORGANIZATION_TOKEN> --env MAILPACE_ALLOWED_RECIPIENTS=<MAILPACE_ALLOWED_RECIPIENTS> --env MAILPACE_REQUEST_TIMEOUT_MS=<MAILPACE_REQUEST_TIMEOUT_MS> --env MAILPACE_MAX_RETRIES=<MAILPACE_MAX_RETRIES> --transport stdio mailpace -- npx -y @mailpace/mcpReplace <…> with your own values
Platform CLI
codex mcp add mailpace --env MAILPACE_API_TOKEN=<MAILPACE_API_TOKEN> --env MAILPACE_ORGANIZATION_TOKEN=<MAILPACE_ORGANIZATION_TOKEN> --env MAILPACE_ALLOWED_RECIPIENTS=<MAILPACE_ALLOWED_RECIPIENTS> --env MAILPACE_REQUEST_TIMEOUT_MS=<MAILPACE_REQUEST_TIMEOUT_MS> --env MAILPACE_MAX_RETRIES=<MAILPACE_MAX_RETRIES> -- npx -y @mailpace/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mailpace": {
"command": "npx",
"args": [
"-y",
"@mailpace/mcp"
],
"env": {
"MAILPACE_API_TOKEN": "<MAILPACE_API_TOKEN>",
"MAILPACE_ORGANIZATION_TOKEN": "<MAILPACE_ORGANIZATION_TOKEN>",
"MAILPACE_ALLOWED_RECIPIENTS": "<MAILPACE_ALLOWED_RECIPIENTS>",
"MAILPACE_REQUEST_TIMEOUT_MS": "<MAILPACE_REQUEST_TIMEOUT_MS>",
"MAILPACE_MAX_RETRIES": "<MAILPACE_MAX_RETRIES>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mailpace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mailpace/mcp"
],
"env": {
"MAILPACE_API_TOKEN": "<MAILPACE_API_TOKEN>",
"MAILPACE_ORGANIZATION_TOKEN": "<MAILPACE_ORGANIZATION_TOKEN>",
"MAILPACE_ALLOWED_RECIPIENTS": "<MAILPACE_ALLOWED_RECIPIENTS>",
"MAILPACE_REQUEST_TIMEOUT_MS": "<MAILPACE_REQUEST_TIMEOUT_MS>",
"MAILPACE_MAX_RETRIES": "<MAILPACE_MAX_RETRIES>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MAILPACE_API_TOKEN=<MAILPACE_API_TOKEN> -e MAILPACE_ORGANIZATION_TOKEN=<MAILPACE_ORGANIZATION_TOKEN> -e MAILPACE_ALLOWED_RECIPIENTS=<MAILPACE_ALLOWED_RECIPIENTS> -e MAILPACE_REQUEST_TIMEOUT_MS=<MAILPACE_REQUEST_TIMEOUT_MS> -e MAILPACE_MAX_RETRIES=<MAILPACE_MAX_RETRIES> mailpace npx -y @mailpace/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MailPace
How do I install MailPace in Claude Code?
Run `claude mcp add mailpace-mcp -e MAILPACE_API_TOKEN=<MAILPACE_API_TOKEN> -e MAILPACE_ORGANIZATION_TOKEN=<MAILPACE_ORGANIZATION_TOKEN> -- npx -y @mailpace/mcp`.
What does MailPace do?
It lets an agent send transactional email, manage MailPace domains and API tokens, and look up email status.
What does MailPace need to run?
It requires Node.js 20 or later, a MailPace organization with a domain, and at least one API token. The domain token enables sending and status checks; the organization token enables domain and token management.