MailFlat — MCP server
Native Model Context Protocol server for
MailFlat. Gives Claude Desktop, Cursor, or any MCP client
disposable inbox tooling — create inboxes, wait for OTP codes, send DKIM-signed mail,
and clean up. Built on the mailflat Python SDK.
Run
# zero-install, isolated (recommended)
MAILFLAT_API_KEY=mf_live_… uvx mailflat-mcp
# or install it
pipx install mailflat-mcp
MAILFLAT_API_KEY=mf_live_… mailflat-mcp
Claude Desktop / Cursor config
Add to claude_desktop_config.json (or your client's MCP config):
{
"mcpServers": {
"mailflat": {
"command": "uvx",
"args": ["mailflat-mcp"],
"env": { "MAILFLAT_API_KEY": "mf_live_..." }
}
}
}
Get your API key from the MailFlat dashboard → Agents.
Tools (10)
| Tool | What it does |
|---|---|
create_inbox(prefix?, label?, retention_hours?) |
Open a disposable inbox; retention_hours capped by your plan |
list_inboxes() |
All inboxes this key can see |
read_messages(address, direction="in") |
Read messages; received mail by default (out / all for the rest) |
wait_for_otp(address, timeout=30) |
Poll until an OTP arrives, then return it |
wait_for_message(address, timeout=30) |
Poll until a new message arrives; ignores mail you sent |
send_email(address, to, subject?, body?, html?) |
Send a DKIM-signed mail from the inbox |
mark_read(address, message_id) |
Mark one message read so later polls skip it |
burn_inbox(address) |
Delete every message but KEEP the address |
delete_inbox(address) |
Delete the inbox and its messages |
delete_message(address, message_id) |
Delete one message; the inbox itself stays |
Reads return received mail by default. Without that, sending to a peer and then waiting for the reply would immediately match your own outgoing message.
Configuration
MAILFLAT_API_KEY— your account API key (required).MAILFLAT_API_URL— override the API base (defaulthttps://mailflat.net; for self-hosted / BYOD).
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mailflat_mcp-0.3.1.tar.gz.
File metadata
- Download URL: mailflat_mcp-0.3.1.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a5d7397b627b983e5526de2d9adfe3ff7d78c621831ef1a27be513ef0b31208
|
|
| MD5 |
374645320d7ee33b0562b94473efbaad
|
|
| BLAKE2b-256 |
4f9021f2b92d60cb327c1c73d736e6b66513203481d53d75d800890e074843f3
|
File details
Details for the file mailflat_mcp-0.3.1-py3-none-any.whl.
File metadata
- Download URL: mailflat_mcp-0.3.1-py3-none-any.whl
- Upload date:
- Size: 6.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
54fc6b4e9a7980d7b4690285f1773f054cc55893bcd8a0e9e9ef5b45eb817d06
|
|
| MD5 |
9b9c6fd7c1884e54ef7558f3a9cb634f
|
|
| BLAKE2b-256 |
c80f7405d93c4db2ddad6dd387360cd9613c00de68c0bf01bde956d66f2486f3
|
