sales-fastmail

What this skill does

# 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

2. **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 Emai