Give your AI agent full email superpowers to read, search, and send messages using Fastmail JMAP.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fastmail-jmap
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install fastmail-jmap using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Fastmail JMAP Email Skill?
This skill provides a lightweight, zero-dependency Python interface for AI agents to interact with email via the Fastmail JMAP API. Unlike traditional IMAP or complex OAuth-based Gmail integrations, it uses a simple API token to enable full mailbox control. By leveraging Openclaw Skills, developers can grant their agents the ability to process invoices, respond to clients, and manage folders without the overhead of external libraries. It is designed to be stateless and fast, making it the perfect choice for headless automation.
Built with a focus on simplicity, the script uses only the Python standard library, ensuring compatibility across various environments. Whether you are building a personal assistant or an automated customer service agent, this skill bridges the gap between LLM logic and your inbox.
Fastmail JMAP Email Skill Use Cases
- Automated inbox monitoring for specific keywords or urgent requests.
- Searching and summarizing past correspondence to provide context for AI tasks.
- Sending automated reports, notifications, or replies directly from the agent.
- Organizing mailboxes by moving emails to specific folders like Invoices or Archive.
- Trashing spam or irrelevant notifications to keep the inbox clean using Openclaw Skills logic.
How Fastmail JMAP Email Skill Works
- The agent authenticates using a Fastmail API token passed via environment variables.
- It uses the JMAP protocol to perform stateless HTTP JSON requests to Fastmail servers.
- For reading, it queries the mailbox, fetches email metadata, and optionally retrieves the full text body.
- For actions like moving or trashing, it sends a set request to update the email's location or flags.
- For sending, it utilizes the EmailSubmission method to dispatch messages via an authorized identity.
Fastmail JMAP Email Skill Setup
To get started, obtain a Fastmail API token with Email (read/write) and Email Submission (send) scopes from your account settings. Then, configure your environment:
export FASTMAIL_TOKEN="fmu1-your-token-here"
# Optional: Override sender identity
export FASTMAIL_IDENTITY="[email protected]"
Verify the connection by running the unread command:
python3 scripts/fastmail.py unread
Fastmail JMAP Email Skill Data Schema & Taxonomy
The skill interacts with the standard JMAP data structures. All IDs are opaque strings used for cross-referencing between commands. This structure is highly compatible with the way Openclaw Skills handle metadata.
| Entity | Description |
|---|---|
| Mailbox | Represents folders and their associated message counts. |
| Contains metadata including ID, Subject, From, Date, and Body text. | |
| Identity | Validated sender addresses used for sending mail. |
| Keywords | Flags like $seen or $draft used for status tracking. |
Fastmail JMAP Email Skill Advanced Features
- Batch request support allows multiple operations in a single API call for high efficiency.
- Global full-text search capability with filters for sender, date ranges, and mailbox folders.
- Stateless architecture ensures no local database sync is required, making it ideal for ephemeral Openclaw Skills environments.
- Custom domain support enables agents to send mail from professional addresses (e.g., bot@yourdomain.com).
- Native integration with 1Password for secure secret injection during runtime.
SKILL.md
Loading
Related Openclaw Skills
Agent Rate Limiter
A zero-dependency Python utility that prevents AI agents from hitting API rate limits through proactive tier-based throttling and automatic exponential backoff.
GoHighLevel Account & App Setup
A comprehensive guide for AI agents to automate GoHighLevel account registration, developer app creation, and API credential management.
ElevenLabs Open Account
A comprehensive guide for developers and creators to set up ElevenLabs accounts and secure API keys for advanced voice AI integrations.
China Mirror Resolver
A self-healing mirror resolver that automatically finds, validates, and configures the fastest domestic download sources for developers in China.
macOS Native Automation
A zero-dependency Python tool for hardware-level mouse and keyboard automation on macOS using CGEvent and AppleScript.
Workspace Audit
A zero-dependency audit suite for OpenClaw workspaces that prevents file drift, secret leaks, and configuration mismatches.
METADATA
Featured*
