📧 FastMail tools

Send email and manage calendar events in Fastmail

Source: openclaw-hub

fastmail_send

Send a plain-text email via Fastmail JMAP, with optional file attachments.

Name Type Required Description
to string Required Recipient email address(es).
subject string Required Email subject line.
body string Required Plain-text email body.
cc array Optional CC recipient email address(es).
signature string Optional Signature block appended after body.
attachment array Optional File path(s) to attach.

Search emails in Fastmail inbox by keyword, sender, subject, or date range via JMAP.

Name Type Required Description
account_id string Optional JMAP account ID (defaults to FASTMAIL_ACCOUNT_ID env).
query string Optional Full-text search query.
from string Optional Filter by sender email or domain.
to string Optional Filter by recipient.
subject string Optional Filter by subject text.
since string Optional Emails after this date (YYYY-MM-DD).
before string Optional Emails before this date (YYYY-MM-DD).
limit integer Optional Max results (default 20).

fastmail_read

Read a specific email by its JMAP email ID, returning full headers and body text.

Name Type Required Description
id string Required JMAP email ID to read.
account_id string Optional JMAP account ID (defaults to FASTMAIL_ACCOUNT_ID env).

fastmail_inbox

Show recent emails from the Fastmail inbox, optionally filtered to unread only.

Name Type Required Description
account_id string Optional JMAP account ID (defaults to FASTMAIL_ACCOUNT_ID env).
limit integer Optional Max emails to show (default 10).
unread boolean Optional Only show unread emails.

fastmail_meeting

Create a calendar meeting invite via CalDAV and send iMIP invitations to attendees.

Name Type Required Description
to string Required Attendee email address(es).
subject string Required Meeting title.
start string Required Start datetime in ISO format (e.g. 2026-03-15T14:00).
cc array Optional CC recipient email address(es).
duration string Optional Duration: ‘1h’, ‘30m’, ‘1.5h’ (default: 1h).
location string Optional Meeting location.
description string Optional Meeting description / agenda.
timezone string Optional IANA timezone (default: America/Los_Angeles).
signature string Optional Signature block for the invite email.

fastmail_update_event

Find a calendar event by UID or text search and update its title, time, location, attendees, or status.

Name Type Required Description
uid string Optional Exact event UID to target.
find string Optional Free-text search across event title/description.
new_title string Optional Replace the event title.
new_start string Optional New start time (ISO format).
new_duration string Optional New duration (e.g. ‘1h’, ‘30m’).
new_location string Optional Replace location.
new_description string Optional Replace description/notes.
timezone string Optional Timezone for –new-start (default: America/Los_Angeles).
status string Optional Update event status. Allowed: confirmed, tentative, cancelled.
add_attendee array Optional Email(s) to add as attendees.
remove_attendee array Optional Email(s) to remove from attendees.
force boolean Optional Update all matching events when multiple found.

fastmail_query_events

Query calendar events by date range, text, attendee email, or UID. Shows attendee RSVP status.

Name Type Required Description
after string Optional Only events starting at or after this date (ISO, e.g. 2026-03-01).
before string Optional Only events starting before this date (ISO, e.g. 2026-04-01).
text string Optional Filter by text match on title/description.
attendee string Optional Filter to events including this attendee email.
uid string Optional Return the single event with this exact UID.