English Français العربية

MCP

Communauté Productivité

Email inboxes for agents that return one-time codes as a field. Addresses are permanent; messages expire after a configurable retention window.

Code source Documentation

Installation

Les étapes d'installation sont dans la documentation ci-dessous. Documentation

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. MailFlat — MCP server
  2. Run
  3. Claude Desktop / Cursor config
  4. Tools (19)
  5. Configuration
  6. Registry
  7. License

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 (19)

ToolWhat it does
create_inbox(prefix?, label?, retention_hours?, subdomain?, domain?)Open an inbox; retention_hours capped by your plan. domain opens it on one of your verified custom domains (bot@acme.com)
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)
wait_until_sent(address, message_id, timeout=60)Did that mail actually go out? A timeout means still queued, not lost: do not send again
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
list_calendar_events(address, include_cancelled=False)Meetings from calendar invitations the inbox received, with this inbox's answer (my_status)
rsvp_to_invite(address, event_id, response, comment?)Accept, decline or tentatively accept; the organizer's calendar shows the answer
create_calendar_event(address, title, start, attendees, ...)Schedule a meeting from the inbox and email the invitations (Yes / No / Maybe in the attendees' calendars)
update_calendar_event(address, event_id, ...)Move or edit a meeting the inbox organized; the same event updates in every calendar
cancel_calendar_event(address, event_id, message?)Cancel a meeting the inbox organized
get_calendar_feed(address)Read-only subscribe link for the inbox's calendar, to hand to a person (Google, Apple, Outlook). The same link on every call
rotate_calendar_feed(address)Replace the subscribe link; the old one stops working at once

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).

Registry

mcp-name: io.github.MailFlat/mailflat-mcp

This line is the ownership marker the official MCP Registry looks for in a PyPI package's README. It proves the same owner controls both the GitHub namespace and the published package, so the registry entry cannot be claimed by someone else. Keep it in sync with the name field in server.json; a test asserts the two match.

License

MIT

Questions fréquentes

Qu'est-ce que MCP ?

Email inboxes for agents that return one-time codes as a field. Addresses are permanent; messages expire after a configurable retention window.

Comment installer MCP ?

Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.

MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient MCP ?

Il est publié par MailFlat. AI.tn le référence sans le maintenir ni le recommander.

Issu des listes communautaires awesome-mcp-servers et du dépôt GitHub du projet. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.