SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillssales-fastmail

sales-fastmail

Marketing & growth

View repository

Updated 10-16 08:43

About this skill

Fastmail Platform Help

Helps with everything related to using Fastmail — the independent, privacy-respecting email service with a full JMAP API, custom domains, Masked Email aliases, and integrated calendar/contacts/files. 20+ years independent, no ads, standards-first.

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

Ask the user:

  1. What are you trying to do with Fastmail?
    • A) Evaluating Fastmail — is it right for me?
    • B) Migrating from Gmail/Outlook/another provider
    • C) Building with the JMAP API (read, send, search, masked email)
    • D) Comparing Fastmail to alternatives (Proton Mail, Hey, Gmail)
    • E) Setting up custom domains, aliases, or Masked Email
    • F) Troubleshooting sync, calendar, or search issues
    • G) Connecting the MCP server to Claude Desktop
    • H) Something else — describe it
  1. Which plan are you on (or considering)?
    • A) Individual (~$5/mo — 60 GB, custom domains, Masked Email)
    • B) Duo (~$8/mo — 2 people, shared calendars)
    • C) Family (~$11/mo — 6 people, 360 GB)
    • D) Business Basic (~$3/user/mo — 6 GB, shared email)
    • E) Business Standard (~$5/user/mo — 60 GB, custom domains)
    • F) Business Professional (~$9/user/mo — 150 GB, retention archive)
    • G) Not sure yet

If the user's request already provides most of this context, skip directly to the relevant step.

Step 2 — Route or answer directly

Problem domain Route to
AI email drafting or triage /sales-superhuman {question} or /sales-shortwave {question}
End-to-end encrypted email /sales-proton-mail {question}
Team shared inbox with ticketing /sales-helpdesk-selection {question}
Inbox cleanup / unsubscribe /sales-clean-email {question}
Server-side email filtering /sales-sanebox {question}
Meeting scheduling /sales-meeting-scheduler {question}

When routing to another skill, provide the exact command.

If the question is about Fastmail itself, continue to Step 3.

Step 3 — Fastmail platform reference

Read references/platform-guide.md for the full platform reference — capabilities, pricing, JMAP API quick-start, migration, MCP server setup.

Read references/fastmail-api-reference.md for detailed API documentation — authentication, endpoints, OAuth flow, Masked Email methods.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

Focus on the user's specific situation:

  • Evaluating Fastmail: Match their priorities. If they need E2E encryption, Proton is better. If they need API access and speed, Fastmail excels. If they need AI, neither — suggest Superhuman or Shortwave.
  • Migration: Use the built-in import tool for Gmail/Outlook. Warn about re-training contacts to use new address.
  • JMAP API: Start with API token auth (simplest). Use OAuth 2.0 with PKCE for production apps. Session endpoint returns all account info.
  • Masked Email: Rate limits apply on creation. Use for signups, newsletters, vendor forms. Integrates natively with 1Password and Bitwarden.
  • MCP server: Community-built (jmhron/FastMailMCP). Requires API token. 7 tools for mailbox management, email search, reading, and sending.

If you discover a gotcha or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research — review these, especially items about pricing and plan features that may change.

  • No native Zapier/Make integration. Unlike many SaaS tools, Fastmail has no official Zapier or Make connector. Automate via JMAP API directly, IMAP polling, or webhook workarounds.
  • Calendar JMAP not yet available. Calendar is CalDAV-only. JMAP calendar support is planned but not shipped yet. Contacts work via both JMAP and CardDAV.
  • Price increases. Fastmail raised prices ~40% in late 2025. Current EUR pricing may differ from older USD references you find online.
  • Android app reported as weak. The web app and iOS are well-regarded; Android has received complaints about UX quality.
  • No AI features. Unlike Superhuman or Shortwave, Fastmail has no AI drafting, categorization, or smart inbox. It's a traditional email client with excellent API access.
  • MCP server is community-built. The FastMailMCP server is not official. It works well but may lag behind API changes.
  • Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.

Related skills

  • /sales-proton-mail — Proton Mail privacy-first encrypted email (E2E encryption, zero-access, no API). Install: npx skills add sales-skills/sales --skill sales-proton-mail -a claude-code
  • /sales-hey — Hey opinionated email service (Screener, Imbox/Feed/Paper Trail, $99/yr). Install: npx skills add sales-skills/sales --skill sales-hey -a claude-code
  • /sales-superhuman — Superhuman fastest AI email client (Split Inbox, AI Write, MCP server, $25-40/mo). Install: npx skills add sales-skills/sales --skill sales-superhuman -a claude-code
  • /sales-shortwave — Shortwave AI-native Gmail client (AI filters, Ghostwriter, MCP consumer, $24-100/mo). Install: npx skills add sales-skills/sales --skill sales-shortwave -a claude-code
  • /sales-em-client — eM Client desktop email client (PGP, calendar/tasks, works with Fastmail via IMAP). Install: npx skills add sales-skills/sales --skill sales-em-client -a claude-code
  • /sales-spark-mail — Spark Mail cross-platform AI email client (works with Fastmail via IMAP). Install: npx skills add sales-skills/sales --skill sales-spark-mail -a claude-code
  • /sales-sanebox — SaneBox server-side email filtering (works with Fastmail). Install: npx skills add sales-skills/sales --skill sales-sanebox -a claude-code
  • /sales-clean-email — Clean Email inbox cleanup (works with any IMAP provider including Fastmail). Install: npx skills add sales-skills/sales --skill sales-clean-email -a claude-code
  • /sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do -a claude-code

Examples

Example 1: Query emails via JMAP API

User says: "How do I search for emails from a specific sender using the Fastmail JMAP API?" Skill does:

  1. Reads API reference for JMAP authentication and Email/query method
  2. Shows: get API token from Settings → Privacy & Security → Manage API tokens
  3. Provides working cURL example: POST to apiUrl with Email/query + filter by from field
  4. Explains result references: chain Email/query → Email/get to fetch full message properties
  5. Notes: use properties parameter to limit returned fields for performance Result: Working API example with auth and query chain

Example 2: Should I use Fastmail or Proton Mail?

User says: "I'm a solopreneur choosing between Fastmail and Proton Mail. I need custom domain email and might want to automate things." Skill does:

  1. Compares: Fastmail has full JMAP API, OAuth 2.0, MCP server; Proton has no API at all
  2. Notes: Proton offers E2E encryption; Fastmail uses TLS + AES at rest (strong but not E2E)
  3. Pricing: comparable — Fastmail Individual ~$5/mo vs Proton Mail Plus ~$4/mo for custom domain
  4. Key decision: if automation/API matters, Fastmail wins decisively. If E2E encryption is top priority, Proton wins.
  5. Neither has AI features — for AI email, suggest Superhuman or Shortwave Result: Clear decision framework based on API needs vs encryption priority

Example 3: Set up Masked Email with 1Password

User says: "How do I use Fastmail's Masked Email feature with 1Password to generate unique email addresses for each service?" Skill does:

  1. Reads platform guide for Masked Email section
  2. Explains: in 1Password, when creating a new login, click the email field → "Generate Masked Email"
  3. Notes: requires Fastmail Individual+ plan and 1Password connected via Settings → Privacy & Security
  4. Warns about rate limits on Masked Email creation via API
  5. Tip: use forDomain to track which service each alias belongs to Result: Step-by-step 1Password integration with rate limit awareness

Troubleshooting

JMAP API returns 401 Unauthorized

Symptom: API calls fail with 401 even though you have a token Cause: Token may be expired, revoked, or missing the required scope. API tokens and app passwords are different — API tokens work with JMAP, app passwords work with IMAP/SMTP. Solution: 1) Verify you're using an API token (not app password) for JMAP. 2) Check token has required scopes (at minimum urn:ietf:params:jmap:core). 3) Use Authorization: Bearer {token} header. 4) If using OAuth, check if access token expired and refresh via /oauth/refresh.

Calendar not syncing with Google Calendar

Symptom: Events added in Fastmail don't appear in Google Calendar or vice versa Cause: Fastmail calendar uses CalDAV, not a direct Google sync. Two-way sync requires subscribing to each other's calendar URLs. Solution: 1) In Fastmail, go to Calendars → Subscribe → paste your Google Calendar ICS URL. 2) In Google Calendar, go to Other calendars → From URL → paste your Fastmail CalDAV URL. 3) Note: this is read-only subscription sync, not true two-way sync. For full sync, use a bridge like CalDAV-to-Google tools.

Masked Email creation fails with rate limit error

Symptom: MaskedEmail/set returns rateLimit SetError Cause: Fastmail rate-limits Masked Email creation to prevent abuse. Creating many aliases in quick succession triggers this. Solution: 1) Wait and retry — rate limits reset after a cooling period. 2) Batch creations with delays between them. 3) If building an integration, implement exponential backoff on rateLimit errors.