Official Verified

guy-fastmail

Access Guy's Fastmail email, contacts, and file storage via JMAP API and WebDAV. Use when the user wants to read, send, search, reply to, or manage email. Also use for contact lookup, searching contacts, or managing files in Fastmail file storage. Supports mailbox management, archiving, flagging, and more.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/flightpath/guy-fastmail

Download Source Code (.zip)

Fastmail (JMAP API)

Full email and contacts access via Fastmail's JMAP API.

Script

scripts/jmap.sh <action> [args...]

Mail Actions

mailboxes — List all mailboxes with unread/total counts
inbox [count] — List recent inbox emails (default 20)
smart-inbox [timeframe] [count] — Smart folder: recent emails from ALL mailboxes (timeframe: today-yesterday|this-week|last-week, default: today-yesterday, count: default 50)
mailbox-emails <mailbox-id> [count] — List emails from a specific mailbox (default 100)
unread [count] — List unread emails (default 20)
read <email-id> — Read full email by ID
search <query> [count] — Search emails by text (default 20 results)
send <to> <subject> <body> [cc] — Send a new email
reply <email-id> <body> [reply-all] — Reply to an email (reply-all: true/false)
move <email-id> <mailbox-id> — Move email to a mailbox (use mailboxes to get IDs)
archive <email-id> — Archive an email
delete <email-id> — Move email to trash
batch-delete — Move multiple emails to trash (reads email IDs from stdin, one per line)
batch-destroy — Permanently delete multiple emails (reads email IDs from stdin, one per line)
create-mailbox <name> [parent-id] — Create a new mailbox/folder
flag <email-id> <flag> <true|false> — Set flag (seen/flagged/answered)

Masked Email Actions

masked-list [count] — List all masked email addresses (default 50)
masked-search <query> — Search masked emails by address, domain, or description
masked-create [domain] [description] — Create a new masked email address
masked-enable <id> — Re-enable a disabled masked email
masked-disable <id> — Disable a masked email (stops forwarding)
masked-delete <id> — Delete a masked email (confirm with user first!)

File Actions (WebDAV)

files-list [path] — List files/folders (default /)
files-upload <local-path> <remote-path> — Upload a file
files-download <remote-path> <local-path> — Download a file
files-mkdir <path> — Create a folder
files-delete <path> — Delete a file or folder (confirm with user first!)

Contact Actions

contacts [count] — List contacts (default 50)
contact-search <query> — Search contacts by name, email, or phone

Calendar Actions (CalDAV)

Read Full Documentation on GitHub

Metadata

Author@flightpath

Stars1335

Updated2026-02-23

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-flightpath-guy-fastmail": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

mac-calendar

Read and manage Apple Calendar on Guy's Macs (MacBook or Mac Mini) over SSH. Use when the user wants to check calendar events, create events, or manage Apple Calendar in any way.

flightpath 1401

mac-files

Search, read, create, edit, and manage files on Guy's Macs (Mac Mini or MacBook) over SSH. Use when the user wants to find files, read documents, create or edit files, organize folders, or manage files on their Mac. Includes Spotlight search via mdfind.

flightpath 1335