Universal Email MCP
An MCP server giving agents a mailbox: send mail, read recent messages, auto setup for QQ, 163, Outlook and enterprise mail.
- 95 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent gets access to read and send mail on your behalf.
- The mailbox password or auth code sits in the client configuration.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/universal-email-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent gets access to read and send mail on your behalf.
- The mailbox password or auth code sits in the client configuration.
This is third-party code. Review the repository files before installing.
What it does
The server connects a mailbox to an MCP client. `send_email` sends text and HTML to several recipients with cc, bcc and attachments. `get_recent_emails` lists mail from the last days and `get_email_content` reads a message by `uid`. The server picks IMAP or POP3 on its own. Settings are detected automatically for QQ, 163, Outlook, Sina, Sohu, and Tencent and Alibaba Cloud enterprise mail. Other servers are configured by hand through `configure_email_server`, and `test_email_connection` checks the link. The address and auth code are passed through `EMAIL_USER`, `EMAIL_PASSWORD` and `EMAIL_TYPE`.
Who it is for. Users of Claude Desktop and other MCP clients who work with Chinese mail providers and Tencent or Alibaba Cloud enterprise mailboxes.
Good fit when
- An agent has to send a report with an attachment to several addresses.
- A summary of mail from the last days is wanted from a QQ or 163 mailbox.
- Tencent or Alibaba Cloud enterprise mail should connect without hand-setting hosts.
- An SMTP problem must be narrowed down with `test_email_connection`.
Not a fit when
- Gmail through OAuth 2.0 is needed; per the package description it is unsupported because of Google policy.
- An agent must not be trusted to send mail without your review.
- Keeping a mailbox password or auth code in an MCP client config is not acceptable.
Example request
Show mail from the last three days and send a summary to my manager with a copy to me.MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
EMAIL_USERrequired- Mailbox address.
EMAIL_PASSWORDrequired, secret- Mailbox password or auth code.
EMAIL_TYPE- Mail provider type: `auto`, `exmail`, `aliyun-enterprise` and others.
Limitations
The README and configuration guide are in Chinese. Enterprise mailboxes require `EMAIL_TYPE`, such as `exmail` or `aliyun-enterprise`; personal ones work with `auto`. Node.js 16 or newer and a mailbox auth code are needed, obtained in the mail provider settings after enabling POP/IMAP/SMTP. Gmail is unsupported because of Google's OAuth 2.0 policy. The author advises keeping the auth code out of version control, storing it in environment variables, rotating it periodically and restricting access to the MCP server.
How to disable. Remove the `universal-email` block from the MCP client config and run `npm uninstall -g mcp-email`. Revoke the auth code in the mail provider.
FAQ
Which tools does the server provide?
Seven: `send_email`, `get_recent_emails`, `get_email_content`, `setup_email_account`, `list_supported_providers`, `configure_email_server` and `test_email_connection`.
How do I connect a Tencent enterprise mailbox?
Enable POP/IMAP/SMTP in the admin console, generate a client password and set `EMAIL_TYPE` to `exmail`. For Alibaba Cloud use `aliyun-enterprise`.
Which password do personal mailboxes need?
The auth code from the mail provider settings, not the login password. For QQ and 163, enable the POP3/IMAP/SMTP service first.
How do I verify the setup?
Call `test_email_connection` from the client. Locally `node test-auto-config.js` runs the check.
Which providers are configured automatically?
QQ, 163, Outlook, Sina, Sohu, and Tencent and Alibaba Cloud enterprise mail. `list_supported_providers` returns the full list.
Discussion
No questions or reviews yet.
Related
MCP serversMCP email server over IMAP and SMTP: an agent searches, reads, sorts and sends mail across several mailboxes
An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends
Email MCP: Yandex, Mail.ru and other providers
Email MCP Server
An HTTP/SSE wrapper around an IMAP MCP server for remote mailbox access from Claude Web: read, search, send, across 15 providers
Email SMTP/IMAP MCP: mail across several accounts
Email SMTP/IMAP MCP
A six-tool mail MCP: one local server searches, reads, sends, forwards and files email across any number of IMAP and SMTP accounts
imap-mcp-server: email over IMAP and SMTP for agents
imap-mcp-server
An MCP server for searching, reading, sending and cleaning up email in several mailboxes, with credentials stored under AES-256
An MCP server for Mail on Mac: an agent reads, searches, writes and sorts email and triages the inbox, with a read-only mode
README in short
Install through npm and from source, sample configs for MCP-X and enterprise mailboxes, steps to get auth codes from major providers and seven tool descriptions with parameters are covered. Sections on troubleshooting and security follow.