fastmail
by witooh
Calendar & SchedulingBrief
Manages Fastmail email and calendar via JMAP and CalDAV APIs.
Description
What This Skill Does
Manages Fastmail email and calendar through JMAP and CalDAV APIs. Covers reading, sending, searching, and bulk-organizing emails, plus creating and managing calendar events, recurring schedules, reminders, and invitations. Timezone is auto-detected from the system or configurable via environment variable.
Handles both email and calendar in one skill with bulk operations and invitation RSVP, which normally require separate tools or manual browser steps.
When to Use It
- Searching inbox for invoices or receipts by keyword
- Bulk archiving or deleting old emails at once
- Creating recurring standup meetings with reminders
- Accepting or declining calendar invitations
- Replying to email threads without opening a browser
Example Workflow
User asks: Find all emails about invoices and move them to the Archive folder
- 1
Call search_emails with query 'invoice' to retrieve matching email IDs
- 2
Call list_mailboxes to find the Archive folder ID
- 3
Call bulk_move_emails with the collected email IDs and the Archive mailbox ID
All matching invoice emails moved to Archive in a single bulk operation
Requirements
- FASTMAIL_API_TOKEN environment variable (from Fastmail Settings → Privacy & Security → Integrations)
- FASTMAIL_USERNAME environment variable (your Fastmail email address)
- FASTMAIL_PASSWORD environment variable (app password generated in Fastmail settings)
- Fastmail account
Installation
clawhub install witooh/fastmailRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.