MailFlat

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mailflat-mailflat-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

6 read · 10 write · 3 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• burn_inbox

  Delete every message in an inbox but KEEP the address. Use between scenarios: the address stays registered wherever you already used it.

• cancel_calendar_event

  Cancel a meeting this inbox organized; it disappears from every attendee's calendar.

• create_calendar_event

  Schedule a meeting from this inbox and email the invitations (you are the organizer). Attendees get a normal invitation with Yes / No / Maybe buttons in Gmail, Outlook or Apple Calendar. Their answers show up in list_calendar_events under `attendees[].status`. `start`: ISO 8601 with an offset ("2026-10-06T14:00:00-04:00"), or without one plus `timezone` ("America/New_York"). Set `end` or `duration_minutes` (default 30 minutes). For an all-day event set all_day=true and use dates ("2026-10-06"); `end` is exclusive. `message` is a short note at the top of the invitation email. `in_reply_to` (a …

• create_inbox

  Open an email inbox and return its address. Use this when you need an address to sign up for a service or to receive a one-time code. The address is permanent and stays until you delete it, so a test suite can reuse one address across runs instead of opening a new inbox each time. Only the messages inside expire, on the retention window you choose. `label` needs a paid plan; on free it is reported back in `ignored_fields`. `retention_hours` is optional (0 = your plan's max); requests above your plan are capped. `subdomain` picks the part after the @ on mailflat.net (`prefix@subdomain.mailfla…

• delete_inbox

  Delete an inbox and all its messages by address. Irreversible.

• delete_message

  Delete a single message in an inbox by its id (the inbox itself stays).

• get_calendar_feed

  Read-only subscribe link for this inbox's calendar, to give to a human. They add it in Google Calendar, Apple Calendar or Outlook and see this inbox's meetings there, with attendees and their answers. Calling again returns the SAME link, so sharing it twice never breaks a subscription. `subscribe_links` holds one-click add links per app. Google refreshes subscribed calendars every 8 to 24 hours; for live state use list_calendar_events.

• list_calendar_events

  List the meetings on an inbox's calendar, soonest first. Events come from calendar invitations this inbox received (Google Calendar, Outlook, ...). Each has an `id`, `title`, `start`/`end` in UTC, `organizer`, `attendees`, `status` ("confirmed" or "cancelled") and `my_status` (this inbox's answer: "needs-action", "accepted", "declined" or "tentative"). If the organizer moves a meeting, the event is updated in place and `my_status` goes back to "needs-action". Messages that carry an invitation also show it under `calendar_event` in read_messages.

• list_inboxes

  List all inboxes available to this API key.

• mark_read

  Mark one message as read so later polls can skip it.

• read_messages

  Read messages in the given inbox address (newest first). `direction` is "in" for received mail (default), "out" for mail sent from this address, or "all" for both. Received mail is the default so that a reply you are waiting for is not confused with a message you just sent.

• reply

  Reply to a message so it stays in the SAME conversation. Prefer this over send_email when answering: it fills in the recipient, an `Re:` subject and the threading headers. A plain send_email starts a new conversation in the recipient's client, which does not look like a reply.

• rotate_calendar_feed

  Replace this inbox's calendar subscribe link; the old link stops working at once. Use only when the link leaked. Everyone subscribed has to add the new link.

• rsvp_to_invite

  Answer a calendar invitation: response is "accepted", "declined" or "tentative". Sends a standard calendar reply email to the organizer, so their Google or Outlook calendar shows your answer. `event_id` comes from list_calendar_events (or `calendar_event.event_id` on a message). Call it ONCE per answer: the reply is queued like any email; use wait_until_sent with the returned `message_id` to confirm delivery.

• send_email

  Send an email FROM the given inbox address (DKIM-signed via MailFlat's MTA). Use for replies or outbound automation. `html` is optional. Returns once the mail is ACCEPTED for delivery, not once it is delivered: delivery runs on a queue and the result arrives via webhook or by reading the message back. `cc` addresses appear in the mail's headers; `bcc` addresses never do — not even in their own copy. Attachments are not available here; send those from the SDK.

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

89

Last commit

Oct 5, 2026 (26 days ago)

Last release

Sep 29, 2026 (1 month ago)

Last package publish

Oct 2, 2026 (29 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.MailFlat/mailflat-mcp

Version

0.9.2

Auth

API key

Packages

pypi mailflat-mcp

License

MIT

Repository

github.com/MailFlat/mailflat-sdks

Website

mailflat.net/docs/ai/mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql