Fastmail API

What This Skill Does

The Fastmail API skill provides a robust framework for managing your Fastmail account directly through the OpenClaw AI agent. By utilizing the JMAP (JSON Meta Application Protocol) standard, this skill allows the agent to perform granular operations across your mailboxes, contacts, and calendar. It acts as an abstraction layer that handles token security, request batching, and session discovery, ensuring that your interactions with the Fastmail backend are both efficient and error-resistant. It maintains a structured local memory in ~/fastmail-api/, enabling the agent to recall your account configuration, preferred mailbox IDs, and a log of high-impact historical actions to provide context-aware automation.

Installation

To install this skill, run the following command in your terminal within the OpenClaw environment: clawhub install openclaw/skills/skills/ivangdavila/fastmail-api

Ensure that your environment variables are configured correctly by setting FASTMAIL_API_TOKEN in your secure shell environment. Refer to setup.md inside the repository for a guided walkthrough of credential handling and account initialization.

Use Cases

• Automated Inbox Cleanup: Search for emails older than 90 days from specific senders and move them to an archive folder or delete them to reclaim space.
• Calendar Syncing: Automatically extract event details from incoming meeting invitations and create corresponding entries in your Fastmail calendar.
• Contact Management: Sync your local contact lists with Fastmail and automate the deduplication or enrichment of contact cards.
• Draft Generation: Create draft responses for repetitive queries by pulling context from the last few messages in a thread.

Example Prompts

1. "Check my inbox for emails from '[email protected]' received in the last 48 hours and move them to the 'Promotions' folder."
2. "Draft a polite response to the latest email from John Doe, acknowledging receipt of the attached document."
3. "Summarize the calendar events scheduled for this coming Friday and list them for me in a table."

Tips & Limitations

• Safety First: The skill implements high-impact confirmation. Always review the request-log.md if the agent executes large batch operations.
• Pagination: Always request pagination or limits when querying large inboxes to avoid triggering API rate limits or excessive local memory usage.
• Token Hygiene: Never hardcode your API token into scripts or configuration files; keep it in a secure environment variable. The skill uses jq to parse responses, so ensure jq is installed on your machine for the best performance.