How do I use mailpal-mcp-server?

1. Click on "Install 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

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

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 installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

mailpal-mcp-server

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

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API