mailpal-mcp-server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mailpal-mcp-server check my inbox for new messages"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mailpal-mcp-server
Free email for AI agents -- MCP server for mailpal.com
npx mailpal-mcp-server
Why MailPal?
Free forever -- every AI agent gets a real
@mailpal.comemail address at no costHardware attestation -- emails are cryptographically signed by your TPM, proving they came from real hardware (via 1id.com). Attestation is ON by default.
Full protocols -- SMTP, IMAP, JMAP, CalDAV, CardDAV. Not a toy API -- a real mail server powered by Stalwart
Related MCP server: InboxAPI CLI
Tools
Tool | Description |
| Create your |
| Send email with hardware attestation ON by default (mode 2 = SD-JWT, mode 1 = direct TPM CMS, mode 0 = none) |
| Check inbox for messages -- returns summaries with sender, subject, date, preview |
| Read full message content including text body, HTML body, and all metadata |
| Subscribe to real-time "You've Got Mail!" notifications when new email arrives |
| Block until new email arrives or timeout (requires subscribe first) |
| Register a webhook URL to POST when new email arrives |
| Remove a previously registered webhook callback |
| Raw JMAP passthrough -- delete, move, flag, search, folders, contacts, calendars, sieve filters, blob upload, anything JMAP supports |
| Get or create a hardware-anchored 1id identity for this agent |
| Full picture of identity, devices, connected services |
| Get an OAuth2 Bearer token for the current identity |
| Sign a verifier-provided nonce to prove hardware identity |
| Verify another agent's identity proof bundle |
| List credential pointers for an identity |
The mailpal_jmap tool gives your agent access to the full JMAP specification (RFC 8620/8621)
and all Stalwart extensions. If a convenience tool doesn't exist for what you need, use this.
Quick Start
1. Get a 1id.com identity
npx 1id enrollThis creates a hardware-anchored identity. The MCP server uses it directly: each MailPal request is signed with your enrolled key (TPM, YubiKey, Secure Enclave or software key), because 1ID tokens are sender-constrained -- a token on its own is refused. There is no token to copy into a config file.
2. Add to your MCP client
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"mailpal": {
"command": "npx",
"args": ["-y", "mailpal-mcp-server"]
}
}
}Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"mailpal": {
"command": "npx",
"args": ["-y", "mailpal-mcp-server"]
}
}
}Windsurf (~/.windsurf/mcp.json):
{
"mcpServers": {
"mailpal": {
"command": "npx",
"args": ["-y", "mailpal-mcp-server"]
}
}
}Environment Variables
Variable | Required | Description |
| No | Override API base URL (default: |
Also Available As
Python:
mailpal-mcpon PyPI --pip install mailpal-mcpREST API:
https://mailpal.com/api/v1/(docs)Direct IMAP/SMTP:
imap.mailpal.com:993/smtp.mailpal.com:587(standard email clients)
Comparison
Feature | MailPal | AgentMail | Robotomail | Nylas |
Free tier | Unlimited | 100 msgs | Limited | Paid |
Real SMTP/IMAP | Yes | API only | API only | Yes |
Hardware attestation | Yes (ON by default) | No | No | No |
CalDAV/CardDAV | Yes | No | No | Yes |
MCP server | Yes | Yes | No | No |
JMAP passthrough | Yes | No | No | No |
Real-time inbox push | Yes | No | No | No |
Self-hostable | Yes (Stalwart) | No | No | No |
Development
git clone https://github.com/mailpal-com/mcp-server.git
cd mcp-server
npm install
npm run build
node dist/index.jsTest with MCP Inspector:
npx -y @modelcontextprotocol/inspectorLicense
Apache-2.0 -- see LICENSE.
Built by Crypt Inc. -- the team behind 1id.com and mailpal.com.
Available Tools
2 toolsmailpalC
Email for AI agents -- send, receive, manage email with hardware attestation (mailpal.com). Call with operation="readme" for full documentation and available operations.
Inputs: operation (required), params.
oneidC
Hardware-anchored identity for AI agents (1id.com). Manage identity, devices, peer verification, and credentials. Call with operation="readme" for full documentation.
Inputs: operation (required), params.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools target clearly different domains (email vs. hardware identity), so an agent can pick between them without confusion. However, both use an identical generic 'operation' gateway pattern, so the actual sub-operations are not visible as distinct entities and require a readme call to disambiguate.
Both tools use the same single-word, lowercase product-name convention (mailpal, oneid), which is internally consistent. They do not follow a verb_noun pattern, but they are consistently named gateways rather than mixed styles.
Only two tools are exposed for what appears to be a broad email and identity ecosystem, which is thin for the apparent scope. Each tool is a mega-gateway hiding an unknown number of operations behind an 'operation' parameter, making the surface feel under-specified.
The visible surface only provides two generic dispatcher tools that require a 'readme' call before any real operation can be discovered. There are no explicit create/read/update/delete operations for email or identity, so coverage is opaque and requires exploration rather than being evident from the tool list.
Related MCP Connectors
Real email inboxes for AI agents: register, receive, read and send mail over MCP. Free to receive.
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Related MCP Servers
AlicenseCqualityCmaintenanceFree email for AI agents with hardware attestation, real SMTP/IMAP/JMAP, and real-time notifications.2Apache 2.0
InboxAPI CLIofficial
AlicenseNot gradedqualityBmaintenanceProvides an AI agent with its own email address to send, receive, and manage emails via MCP. No email server setup required.22 npm13MIT- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI agents to validate email addresses and send emails via SMTP with zero external dependencies.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that acts as an email gateway for Gmail and Microsoft 365, enabling AI agents to send and read emails via MCP tools, with SMTP/IMAP and REST APIs for email sequencing and automation.1AGPL 3.0