MailFlat — MCP server

Native Model Context Protocol server for MailFlat. Gives Claude Desktop, Cursor, or any MCP client real inbox tooling: create inboxes, wait for OTP codes, send DKIM-signed mail, and clean up when the task is done. Each address is permanent and stays until you delete it; only the messages inside expire, on a retention window you choose. 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 (11)

Tool	What it does
`create_inbox(prefix?, label?, retention_hours?)`	Open an 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
`reply(address, message_id, body?, html?)`	Answer a message in the same conversation (threading headers filled in)
`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 (default https://mailflat.net; for self-hosted / BYOD).

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mailflat_mcp-0.9.1.tar.gz (9.9 kB view details)

Uploaded Aug 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mailflat_mcp-0.9.1-py3-none-any.whl (10.9 kB view details)

Uploaded Aug 23, 2026 Python 3

File details

Details for the file mailflat_mcp-0.9.1.tar.gz.

File metadata

Download URL: mailflat_mcp-0.9.1.tar.gz
Upload date: Aug 23, 2026
Size: 9.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for mailflat_mcp-0.9.1.tar.gz
Algorithm	Hash digest
SHA256	`611458e3826a68168ef8e37dc4e0dc1d9e3c6a22be9e28c0cc5ebc9d4a94e77f`
MD5	`21c660f1f0767611fdccb62b352fa6e8`
BLAKE2b-256	`a19865f4038abb1314af58b52b1ed2a919428a44308b9f3286d123463b08747d`

See more details on using hashes here.

File details

Details for the file mailflat_mcp-0.9.1-py3-none-any.whl.

File metadata

Download URL: mailflat_mcp-0.9.1-py3-none-any.whl
Upload date: Aug 23, 2026
Size: 10.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for mailflat_mcp-0.9.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d20c04a38cd8f9a86a2c0a497e78a847abf4288be94a7729029ec249a378cc1f`
MD5	`888d91bf0e4627f9a39545641074f158`
BLAKE2b-256	`8dab3558569da42b6a7ed959cfa2efc65d9467d5e89117d886e51c8d7460cbc4`