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 (7)
| 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) |
Read every message in an inbox |
wait_for_otp(address, timeout=30) |
Poll until an OTP arrives, then return it |
send_email(address, to, subject?, body?, html?) |
Send a DKIM-signed mail from the inbox |
delete_inbox(address) |
Delete the inbox and its messages |
delete_message(address, message_id) |
Delete one message; the inbox itself stays |
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.2.3.tar.gz.
File metadata
- Download URL: mailflat_mcp-0.2.3.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7eb298277486fd3ef0d2740f037c41c31ef0a0d0de8452e12b746234c2a3b238
|
|
| MD5 |
d2a60f72f8b33efe87367b2733150d21
|
|
| BLAKE2b-256 |
4cea1cc9b726fe93e07f2dbe8b33cc4c825a0576e176b3cac2ea796167e09e9e
|
File details
Details for the file mailflat_mcp-0.2.3-py3-none-any.whl.
File metadata
- Download URL: mailflat_mcp-0.2.3-py3-none-any.whl
- Upload date:
- Size: 5.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
484476b01615a5e9651944deee13ddf8a2ebde858a50556a7906e5e9c891a646
|
|
| MD5 |
d3c8206ba49f0df265a3f15b3fcbfb22
|
|
| BLAKE2b-256 |
6cbec6f218428283bdb9c01cdaa7d5a2e5cfc94564d4bc2a894f78dba2cdd551
|
