Better Email Mcp
by n24q02mcommunityv1.21.0
6
2
Better Email MCP is an IMAP/SMTP email server designed for AI agents, supporting multi-account management and auto-discovery of provider settings.
From the registry: IMAP/SMTP MCP server for Email with composite tools. Multi-account, auto-discovery.
Install & configure
Prerequisites
- requiredEmail account + app passwordGenerate an app password for each email account (Gmail, Yahoo, iCloud, Zoho). Outlook uses OAuth2 device code flow automatically.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `better-email-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Email account + app password** — Generate an app password for each email account (Gmail, Yahoo, iCloud, Zoho). Outlook uses OAuth2 device code flow automatically.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@n24q02m/better-email-mcp"]
- optional environment variables:
- `EMAIL_CREDENTIALS`: Comma-separated credentials in email:app-password form (or email:pass:imap.host for custom IMAP). Optional — server can instead use a browser-based relay setup on first run. (example: `<your-email>:<your-app-password>`)
Note: Hosted multi-user HTTP endpoint uses OAuth 2.1 for credentials. stdio npx path is the default local install; zero-config relay setup is offered if EMAIL_CREDENTIALS is unset.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Hosted multi-user HTTP endpoint uses OAuth 2.1 for credentials. stdio npx path is the default local install; zero-config relay setup is offered if EMAIL_CREDENTIALS is unset.
Tools (6)
messages
Search, read, and organize emails
folders
List mailbox folders
attachments
List and download email attachments
send
Compose, reply, and forward emails
setup
Credential setup via browser relay, status check, reset, re-resolve
help
Get full documentation for any tool
Environment variables
EMAIL_CREDENTIALSrequiredEmail credentials in the format `user@gmail.com:app-password`, comma-separated for multi-accountPUBLIC_URLrequiredServer's public URL for OAuth redirectsDCR_SERVER_SECRETrequiredHMAC secret for stateless client registrationPackages
@n24q02m/better-email-mcp
npmv1.21.0transport: stdio
docker.io/n24q02m/better-email-mcp:latest
ocitransport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Apr 7, 2026
- Last commit
- Apr 12, 2026
- Registry name
- io.github.n24q02m/better-email-mcp