fastmail-suiteSecure, safe-by-default Fastmail integration (email, contacts, calendar) via JMAP + CalDAV. Use when you want to verify Fastmail setup, triage/search email,...
Install via ClawdBot CLI:
clawdbot install TassieDaddy/fastmail-suiteUse the bundled scripts (stdlib-only) to interact with Fastmail safely.
Set credentials/tokens:
# JMAP token (Mail + Contacts scopes)
export FASTMAIL_TOKEN='…'
# CalDAV app password (calendar)
export FASTMAIL_CALDAV_USER='you@yourdomain'
export FASTMAIL_CALDAV_PASS='app-password'
# Optional: redact output (default is 1)
export FASTMAIL_REDACT=1Verify setup:
python3 skills/fastmail-suite/scripts/suite.py statuspython3 skills/fastmail-suite/scripts/suite.py statusExpected style:
Mail (JMAP): OK / MISSING TOKEN / AUTH FAILEDCalendar (CalDAV): OK / MISSING APP PASSWORD / AUTH FAILEDContacts (JMAP): OK / MISSING TOKEN / AUTH FAILEDpython3 skills/fastmail-suite/scripts/suite.py triage today
python3 skills/fastmail-suite/scripts/suite.py triage last-7dTriage summarizes:
invoice, bill, payment, due, confirm, action required, reminder, ...),friends.tas.edu.au and bill/payment-like items.python3 skills/fastmail-suite/scripts/suite.py search "from:billing@ subject:invoice last:7d"
python3 skills/fastmail-suite/scripts/suite.py search "has:attachment before:2026-02-01 tax"
python3 skills/fastmail-suite/scripts/suite.py search "after:2026-02-01 reminder"Supported query tokens:
from:foosubject:barhas:attachmentlast:7d (and other Nd forms)before:YYYY-MM-DDafter:YYYY-MM-DDpython3 skills/fastmail-suite/scripts/suite.py thread <email-id>
python3 skills/fastmail-suite/scripts/suite.py thread <thread-id>
python3 skills/fastmail-suite/scripts/suite.py thread "school invoice"Shows concise thread summary:
python3 skills/fastmail-suite/scripts/fastmail.py mail inbox --limit 20
python3 skills/fastmail-suite/scripts/fastmail.py mail search "invoice" --limit 10
python3 skills/fastmail-suite/scripts/fastmail.py mail read <email-id>python3 skills/fastmail-suite/scripts/fastmail.py contacts list --limit 20
python3 skills/fastmail-suite/scripts/fastmail.py contacts search "alice" --limit 5
python3 skills/fastmail-suite/scripts/fastmail.py contacts get <contact-id>python3 skills/fastmail-suite/scripts/fastmail.py calendar calendars
python3 skills/fastmail-suite/scripts/fastmail.py calendar upcoming --days 7Fastmail Suite works with real Fastmail credentials, so the design is intentionally conservative.
FASTMAIL_TOKEN — Fastmail JMAP API token (Mail + Contacts scopes). Best practice is to use a read-only token for normal usage.FASTMAIL_TOKEN_SEND — separate JMAP token with Email Submission scope for sending mail. Only used if you explicitly enable writes.FASTMAIL_CALDAV_USER / FASTMAIL_CALDAV_PASS — Fastmail app password for calendar (CalDAV).FASTMAIL_REDACT — controls redaction of output (default 1 = redacted).FASTMAIL_ENABLE_WRITES — when set to 1, enables write operations (send/move/update). Omit or set to 0 to keep read-only. Output is redacted unless you pass --raw where supported. FASTMAIL_REDACT=1 is the default.
The skill will not send/move/update anything unless FASTMAIL_ENABLE_WRITES=1 and you have provided appropriate tokens (for example FASTMAIL_TOKEN_SEND for sending mail).
You can keep a strict separation:
FASTMAIL_TOKENFASTMAIL_TOKEN_SEND (optional, only when writes are enabled)FASTMAIL_CALDAV_USER + FASTMAIL_CALDAV_PASS (Fastmail app password)You can run the entire suite (status, triage, search, thread, contacts, calendar read) with a read-only JMAP token + calendar app password, without ever enabling writes.
list, search, get) tested against real Fastmail accounts.suite.py status now probes Contacts via JMAP and reports Contacts (JMAP) health.scripts/suite.py with onboarding status checks for JMAP + CalDAV.triage todaytriage last-7dsearch with token parser (from:, subject:, has:attachment, last:, before:, after:)thread conversation summaryscripts/fastmail.py for suite ....Generated Mar 1, 2026
Individuals can use this skill to securely triage and search personal emails, manage contacts, and view calendar events without risking accidental writes. The default redaction protects sensitive data, making it safe for daily use with read-only tokens.
Small business owners can automate the search for invoice and payment-related emails using the search and triage features. This helps track billing communications efficiently while maintaining security through redacted outputs and separate read/write tokens.
Schools or universities can monitor emails from specific domains like 'friends.tas.edu.au' and manage reminders or event schedules via calendar integration. The skill's thread summary feature aids in reviewing communication threads for administrative purposes.
Freelancers can organize client emails, search for project-related threads, and schedule meetings using the calendar features. The separation of read and write tokens ensures safe email handling without unintended sends or updates.
Offer this skill as part of a paid subscription service for individuals and small businesses needing secure email and calendar management. Revenue comes from monthly fees for enhanced features like advanced search filters or priority support.
License the skill to enterprises for internal use, focusing on its safety features like redaction and least-privilege tokens. Revenue is generated through one-time licensing fees or annual contracts for customization and support.
Provide a free tier with basic read-only functions and redaction, then charge for write capabilities, higher API limits, or integration with other tools. Revenue streams include premium subscriptions and pay-per-use for advanced features.
💬 Integration Tip
Start with read-only tokens and redaction enabled to ensure safety; only enable writes after verifying setup with the status command to avoid accidental data changes.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Automatically logs into email accounts (Gmail, Outlook, QQ Mail, etc.) and generates daily email summaries. Use when the user wants to get a summary of their emails, check important messages, or create daily email digests.
Fetch content from Feishu (Lark) Wiki, Docs, Sheets, and Bitable. Automatically resolves Wiki URLs to real entities and converts content to Markdown.
Manage Feishu (Lark) calendars by listing, searching, checking schedules, syncing events, and marking tasks with automated date extraction.