fastmail

What This Skill Does

The Fastmail skill provides a robust bridge between the OpenClaw AI agent and your email and calendar ecosystem via the JMAP and CalDAV protocols. It acts as an intelligent assistant capable of managing your communications and scheduling tasks with high precision. By automating inbox management—such as sorting, reading, and replying to emails—as well as comprehensive calendar oversight, it reduces the friction of manual administrative work. Whether you are dealing with high volumes of incoming mail or complex scheduling conflicts, the agent handles the heavy lifting directly through your command line or natural language prompts.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/witooh/fastmail

Once installed, navigate to the skill directory at .opencode/skills/fastmail and run bun install to ensure all required dependencies for the JMAP and CalDAV client libraries are satisfied. You can verify the installation and view the full toolset by executing bunx fastmail --list.

Use Cases

This skill is designed for power users who need to maintain inbox zero and keep their calendars perfectly synchronized. Typical use cases include:

• Aggregating and summarizing threads from long email chains.
• Automating the organization of incoming emails into specific folders based on search queries.
• Bulk cleanup of promotional emails or old notifications.
• Rapid scheduling of recurring meetings and handling RSVPs without opening a web browser.
• Creating time-sensitive events with pre-configured reminders to ensure you never miss a deadline.

Example Prompts

1. "Check my inbox for any emails containing 'invoice' and move them to the Finance folder."
2. "Create a meeting titled 'Project Review' for tomorrow at 2 PM, include a 15-minute reminder, and invite [email protected]."
3. "Search for the conversation about the server migration and summarize the last five emails for me."

Tips & Limitations

• Timezone Detection: The skill automatically detects your system timezone; ensure your host machine clock is synced correctly to avoid scheduling errors.
• Batch Processing: Utilize the bulk tools (bulk_move_emails, bulk_delete_emails) whenever performing operations on multiple messages to optimize execution time and API rate limit usage.
• Scope: This skill strictly manages Fastmail-hosted accounts via official protocols. It cannot directly modify calendars hosted on non-CalDAV compatible providers.