MailMCP 📬
Read, search, and draft email from any AI agent — over standard IMAP. Local, free, private.
Works with Gmail, Outlook, Fastmail, or any IMAP server. Never sends: drafts are written to your Drafts folder; a human always presses Send.
Setup
- Enable IMAP for your account. Gmail: turn on 2FA, create an App Password (myaccount.google.com → Security → App passwords).
- Add the server with credentials in the env block:
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"mail": {
"command": "uvx",
"args": ["mcpproducts-mail"],
"env": {
"IMAP_HOST": "imap.gmail.com",
"IMAP_USER": "you@gmail.com",
"IMAP_PASS": "your-app-password"
}
}
}
}
Tools
| Tool | Tier | What it does |
|---|---|---|
list_recent |
free | Latest headers from any folder |
search_emails |
free | IMAP search: FROM/TO/SUBJECT/BODY + since-days |
read_email |
free | Full message body + attachment names |
draft_email |
free | Create a draft (never sends) |
move_email |
free | Move message to another folder (archive/junk) |
cloud_digest |
cloud | Summarised daily inbox brief (needs MPX_API_KEY) |
Example prompts
- "Any email from Stripe this week?" →
search_emails - "Draft a reply to John agreeing to Thursday" →
draft_email - "Archive everything from notifications@twitter" →
search_emails+move_email
License
MIT
Metadata
Release files for mcpproducts-mail 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcpproducts_mail-0.1.1.tar.gz | 4.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcpproducts_mail-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.4 kB
Release files / mcpproducts_mail-0.1.1.tar.gz
| Download URL | mcpproducts_mail-0.1.1.tar.gz |
|---|---|
| Size | 4.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f46a4157748738ca1ce955a379f7826c1445689548dc5e2186fbc1c23120d172
|
|
BLAKE2b-256 checksum How to use checksums |
aca9c70f5d4165f377003d670af7f7c4a2687e1e7a80fd6393572f392d49d5af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcpproducts_mail-0.1.1-py3-none-any.whl
| Download URL | mcpproducts_mail-0.1.1-py3-none-any.whl |
|---|---|
| Size | 5.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ef058bb44360d351f973db5554abe901443781c2b7a8bc33ac1d68fd69a99485
|
|
BLAKE2b-256 checksum How to use checksums |
f55b16c43ba07792a2a5286bca88c7314601d593c7a844b900d6f13ab714825c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|