How do I use mailpal-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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

Official

by mailpal-com

Overview Schema Source Related Servers Discussions Admin

JavaScript

Hybrid

mailpal-mcp-server

Free email for AI agents -- MCP server for mailpal.com

npx mailpal-mcp-server

npm License

Why MailPal?

Free forever -- every AI agent gets a real @mailpal.com email address at no cost
Hardware 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
`mailpal_activate_account`	Create your `@mailpal.com` email address (two-phase Proof-of-Intelligence challenge)
`mailpal_send_email`	Send email with hardware attestation ON by default (mode 2 = SD-JWT, mode 1 = direct TPM CMS, mode 0 = none)
`mailpal_check_inbox`	Check inbox for messages -- returns summaries with sender, subject, date, preview
`mailpal_read_message`	Read full message content including text body, HTML body, and all metadata
`mailpal_subscribe_to_inbox`	Subscribe to real-time "You've Got Mail!" notifications when new email arrives
`mailpal_wait_for_email`	Block until new email arrives or timeout (requires subscribe first)
`mailpal_register_email_callback`	Register a webhook URL to POST when new email arrives
`mailpal_unregister_email_callback`	Remove a previously registered webhook callback
`mailpal_jmap`	Raw JMAP passthrough -- delete, move, flag, search, folders, contacts, calendars, sieve filters, blob upload, anything JMAP supports
`oneid_get_or_create_identity`	Get or create a hardware-anchored 1id identity for this agent
`oneid_status`	Full picture of identity, devices, connected services
`oneid_get_bearer_token`	Get an OAuth2 Bearer token for the current identity
`oneid_sign_challenge`	Sign a verifier-provided nonce to prove hardware identity
`oneid_verify_peer_identity`	Verify another agent's identity proof bundle
`oneid_list_credential_pointers`	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 enroll

This creates a hardware-anchored identity and gives you a JWT token.

2. Add to your MCP client

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mailpal": {
      "command": "npx",
      "args": ["-y", "mailpal-mcp-server"],
      "env": {
        "MAILPAL_TOKEN": "<your-1id-jwt>"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mailpal": {
      "command": "npx",
      "args": ["-y", "mailpal-mcp-server"],
      "env": {
        "MAILPAL_TOKEN": "<your-1id-jwt>"
      }
    }
  }
}

Windsurf (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "mailpal": {
      "command": "npx",
      "args": ["-y", "mailpal-mcp-server"],
      "env": {
        "MAILPAL_TOKEN": "<your-1id-jwt>"
      }
    }
  }
}

3. Or use the hosted endpoint (zero install)

{
  "mcpServers": {
    "mailpal": {
      "type": "streamable-http",
      "url": "https://mailpal.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-1id-jwt>"
      }
    }
  }
}

The hosted endpoint also supports real-time "You've Got Mail!" notifications via MCP resource subscriptions and SSE.

Environment Variables

Variable	Required	Description
`MAILPAL_TOKEN`	Yes	1id.com JWT token for authentication
`MAILPAL_API_URL`	No	Override API base URL (default: `https://mailpal.com/api/v1`)

Also Available As

Python: mailpal-mcp on PyPI -- pip install mailpal-mcp
Hosted endpoint: https://mailpal.com/mcp (Streamable HTTP, supports real-time notifications)
REST 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.js

Test with MCP Inspector:

npx -y @modelcontextprotocol/inspector

License

Apache-2.0 -- see LICENSE.

Built by Crypt Inc. -- the team behind 1id.com and mailpal.com.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

CryptoAgentMail
io.github.influqa
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Email Communication
21
AgenticEmail A
dev.agenticemail
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email Communication
2
email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
302
AgentMailOAuth
to.agentmail
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Email Communication
2

Related MCP Servers

mailpal-mcpofficial
Email Security
mailpal-com
A
license
C
quality
C
maintenance
Free email for AI agents with hardware attestation, real SMTP/IMAP/JMAP, and real-time notifications.
Updated 2 months ago (2026-07-21 22:35 UTC)
2
Apache 2.0
InboxAPI CLIofficial
Email Communication
inboxapi
A
license
Not graded
quality
C
maintenance
Provides an AI agent with its own email address to send, receive, and manage emails via MCP. No email server setup required.
Updated 3 months ago (2026-06-18 06:02 UTC)
54 npm
12
MIT
mcp-email-sender
AMEOBIUS-space
A
license
Not graded
quality
C
maintenance
An MCP server that enables AI agents to validate email addresses and send emails via SMTP with zero external dependencies.
Updated 2 months ago (2026-07-22 15:32 UTC)
MIT
OutreachEmailMCP
Email Communication
BreazyLabs
A
license
Not graded
quality
B
maintenance
MCP 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.
Updated 2 days ago (2026-09-13 18:43 UTC)
AGPL 3.0

mailpal-mcp-server

Why MailPal?

Tools

Quick Start

1. Get a 1id.com identity

2. Add to your MCP client

3. Or use the hosted endpoint (zero install)

Environment Variables

Also Available As

Comparison

Development

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mailpal-mcpofficial

InboxAPI CLIofficial

mcp-email-sender

OutreachEmailMCP