Fastmail CLI

Query and manage Fastmail email, contacts, and calendar via command line.

7|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/omarshahine/fastmail-mcp-remote --skill fastmail-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Fastmail CLI
Source: https://github.com/omarshahine/fastmail-mcp-remote/tree/main/cli
Command: npx skills add https://github.com/omarshahine/fastmail-mcp-remote --skill fastmail-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of accessing Fastmail mail, contacts, and calendar data from AI assistants by giving you a token-efficient command-line workflow that talks to a remote MCP server.

Core Features & Use Cases

  • Inbox & Email Reading: Quickly list recent emails and open an email or full thread in compact, LLM-friendly format.
  • Searching & Filtering: Find emails using queries plus practical filters like sender, subject, dates, unread-only, attachments, and mailbox scoping.
  • Writing & Updating Mail: Send, draft, reply (with correct threading rules), and perform common actions like mark read/unread, flag, delete, move, and attachments handling.

Quick Start

Run fastmail auth --url https://your-worker.example.com --team myteam, then ask fastmail inbox to see recent emails and use the listed email IDs to open or reply.

Frequently Asked Questions about Fastmail CLI

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and read Fastmail emails from the terminal?

To search and read Fastmail emails from the terminal, use the command-line interface to list recent inbox items and open individual messages or full threads. It formats output in a compact, LLM-friendly way for efficient viewing.

What do I need to manage Fastmail email via a command-line interface?

Managing Fastmail email via a command-line interface requires a valid MCP Worker URL and a cached OAuth Bearer token. You authenticate by running the auth command with your specific worker and team parameters.

Can I reply to email threads and apply actions like move or delete using a terminal CLI?

Yes, you can reply to email threads and apply actions using a terminal CLI. The interface supports correct reply threading rules, along with common mail actions like mark read, flag, delete, and move.

How does token efficiency work when querying Fastmail contacts and calendar data?

Token efficiency when querying Fastmail contacts and calendar data works by using a remote MCP server to return compact, LLM-friendly formats. This reduces context window usage when listing or managing large volumes of data.

What email filters can I use when searching my Fastmail inbox through a CLI?

When searching your Fastmail inbox through a CLI, you can use practical filters including sender, subject, dates, unread-only, attachments, and mailbox scoping. This narrows down results efficiently.

Is strict input validation required for Fastmail CLI resource IDs and dates?

Yes, strict input validation is required for Fastmail CLI resource IDs, dates, text fields, and query strings. This ensures commands correctly target specific emails, threads, and calendar events without errors.