CLI for AI agents to access Fastmail via JMAP - draft responses without sending
Project description
fastmail-cli
Read-only email access for AI agents via JMAP, and draft responses.
Demo
Installation
uv add fastmail-cli
Or run without installing:
uvx fastmail-cli help
Setup
export FASTMAIL_API_TOKEN="fmu1-..." # from Fastmail Settings → Integrations
Usage
# Read
fastmail-cli email.query --limit 5 # recent emails
fastmail-cli email.query --filter '{"from":"alice"}' # search
fastmail-cli email.get --ids '["M123"]' # full email by ID
fastmail-cli mailbox.query # list mailboxes
fastmail-cli thread.get --ids '["T456"]' # get thread
# Draft (safe for AI agents - human reviews before sending)
fastmail-cli email.draft --to "bob@x.com" --subject "Hi" --body "..."
fastmail-cli email.draft-reply --id "M123" --body "Thanks!"
fastmail-cli email.draft-reply --id "M123" --body @reply.txt --reply-all
# Advanced
fastmail-cli email.changes --since-state "abc123" # poll for changes
fastmail-cli searchsnippet.get --email-ids '["M1"]' --filter '{"text":"foo"}'
fastmail-cli describe email.query # show command options
All output is JSON with ok, command, meta, and data/error fields.
Required Reading
License
Apache 2.0
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
fastmail_cli-0.2.1.tar.gz
(3.4 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fastmail_cli-0.2.1.tar.gz.
File metadata
- Download URL: fastmail_cli-0.2.1.tar.gz
- Upload date:
- Size: 3.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1b60b09a09f97c9f49a14c4854243d085fbd71a3a131c95513451250464e9061
|
|
| MD5 |
8e921160e0a7a1fd3ef43422b02dd144
|
|
| BLAKE2b-256 |
21f3405c5a4dd900a4d4e5edb6c8c1be18a69a86e5a6fd20e7e0d4094912023b
|
File details
Details for the file fastmail_cli-0.2.1-py3-none-any.whl.
File metadata
- Download URL: fastmail_cli-0.2.1-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a55155f358e47e461c14c3a58c6af88d675faff996271a230feef49dbcb2a0c
|
|
| MD5 |
73f77947d4040f2f5d82264dd73014c2
|
|
| BLAKE2b-256 |
932bab74a48573442fde8cc20d8e83ee0f479c834d83973667d013e3fa325529
|
