A high-performance, zero-dependency Python skill that enables AI agents to manage email through the modern Fastmail JMAP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fastmail-jmap-disabled
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-disabled 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 for AI Agents?
Give your AI agent the ability to interact with the world via email. This skill provides a streamlined interface for reading, searching, and sending messages using the Fastmail JMAP protocol. Unlike complex Gmail OAuth integrations, this approach uses a simple API token, making it perfect for developers building Openclaw Skills who need headless email automation without the configuration headaches. It is built on pure Python with zero external dependencies for maximum portability.
By leveraging the JMAP protocol, this skill offers a modern alternative to legacy IMAP/SMTP setups. It allows agents to perform complex mail operations—like finding specific invoices or trashing spam—with high speed and minimal overhead. It provides a robust bridge between your AI's decision-making logic and your actual inbox.
Fastmail JMAP Email for AI Agents Use Cases
- Automated inbox monitoring for urgent client requests or alerts
- Searching and extracting data from invoices or receipts for bookkeeping
- Sending automated status updates or replies with human-in-the-loop approval
- Organizing emails into specific mailboxes based on AI-driven content analysis
- Managing professional communication workflows directly through a headless agent
How Fastmail JMAP Email for AI Agents Works
- The skill initializes using a Fastmail API token provided via environment variables.
- It establishes a connection to Fastmail servers using the modern, JSON-based JMAP protocol over HTTP.
- For queries, the script utilizes the Email/query method to filter messages by date, sender, or full-text keywords.
- It retrieves specific email content, including the text body, using the Email/get method.
- Management actions like moving, marking as read, or trashing are executed via the Email/set method.
- For outbound communication, it resolves the user identity and submits messages via the EmailSubmission/set method.
Fastmail JMAP Email for AI Agents Setup
To integrate this with your Openclaw Skills workflow, follow these steps:
# 1. Obtain a Fastmail API token from Settings > Security > API Tokens
# Ensure 'Email' (read/write) and 'Email Submission' scopes are enabled
# 2. Set your environment variable
export FASTMAIL_TOKEN="fmu1-your-token-here"
# 3. Verify the installation by checking your unread mail
python3 scripts/fastmail.py unread
Fastmail JMAP Email for AI Agents Data Schema & Taxonomy
The skill manages email data statelessly using the following structures:
| Data Element | Description | Format |
|---|---|---|
| Email ID | Unique identifier for messages | Opaque string (e.g., M1234abcd) |
| Mailboxes | Folder structure and counts | JSON object via Mailbox/get |
| Search Parameters | Criteria for finding mail | Query flags: --from, --after, --before |
| Message Body | The content of the email | Plain text extracted from fetchTextBodyValues |
| Identity | Sender information | Resolved sender address for outgoing mail |
Fastmail JMAP Email for AI Agents Advanced Features
- Global full-text search across all folders without needing to sync local data
- Batch request processing to perform multiple email operations in a single API call
- Stateless execution architecture ensuring compatibility with ephemeral agent environments
- Support for custom sender identities and aliases for professional domain usage
- Lightweight footprint using only the Python 3 standard library for maximum security
SKILL.md
Loading
Related Openclaw Skills
ClawJob
ClawJob is a decentralized job marketplace where AI agents can post, claim, and complete technical bounties to earn $JOBS tokens on the Base network.
Public.com Account Manager
A comprehensive AI-powered skill for managing Public.com brokerage accounts, enabling real-time trading, portfolio tracking, and options analysis.
Orderly Network UI Components
A comprehensive toolkit for developing high-performance decentralized exchange interfaces using pre-built React components.
Orderly Network Trading Orders
A comprehensive developer skill for executing and managing crypto trading orders on the Orderly Network through REST API or React SDK integrations.
Fastmail Suite
A secure, safety-first integration for managing Fastmail email, contacts, and calendars through AI agents using JMAP and CalDAV.
Stock Strategy Backtester Clean
A professional-grade tool for backtesting stock trading strategies on historical price data to quantify risk and return metrics.
Featured*
