imail-mcp — Apple Mail CLI (imail) + MCP-friendly agent schema. Typer.
Project description
imail — Apple Mail CLI (+ MCP)
Package brand: imail-mcp · CLI: imail · PyPI today: pip install mac-imail (target PyPI name imail-mcp when PyPI new-project limit clears).
imsg-style local Mail tool. Name family: imsg · imail · inotes · wa.
Install
pip install -e ".[dev]" # from repo root
# or (future) brew install imail
After install, the imail command is on your PATH (via pip entry point). The old bash script is preserved as imail.bash.bak for reference.
CLI-first vs MCP
| Surface | Binary | When |
|---|---|---|
| CLI (prefer) | imail |
accounts / list / send / organize — saves tokens |
| MCP | mcp-apple-mail (apple-mail) |
full search/compose/organize in agents |
No himalaya. Mail.app only. Permissions: Automation → Mail.
Account walls
Work (Polaris/Exchange) and personal (Google, metropol, lupfr) must never mix. Auto-send must pass --from on the correct wall.
imail walls
Configuration lives in accounts.json at repo root.
Commands
imail -h
imail doctor
imail accounts
imail list --limit 20
imail list --account Exchange --mailbox INBOX --json
imail organize --account polaris --limit 100
imail send --from mlubich@polariswireless.com --to a@b.com \
--subject "Hi" --body "Hello"
imail version
Legacy wrapper (same as imail organize):
python3 organize-all.py --account google --limit 200
Agent introspection
Agents can discover the full command catalog as JSON:
imail agent schema
imail agent guide
imail agent -h
Example schema excerpt:
{
"version": "0.1.0",
"tool": "imail",
"walls": { "work": { ... }, "personal": { ... } },
"commands": [ { "name": "list", "help": "...", "params": [...] } ]
}
MCP stopgap: patrickfreyer/apple-mail-mcp (~179★).
This repo is the CLI we own and grow.
Development
cd ~/dev/imail
python3 -m pip install -e ".[dev]"
pytest -q
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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 imail_mcp-0.1.1.tar.gz.
File metadata
- Download URL: imail_mcp-0.1.1.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4f62acd0cf2ec75df71e7e9fb8f39e40968dadfb0343407f60ff2a2d86eb64a4
|
|
| MD5 |
3ded34d5335a1847038cbc77a856f30d
|
|
| BLAKE2b-256 |
546b6c39cba9238e5a596f8133f9ceababe9007d51325ddc47b28132f9bbb7dd
|
File details
Details for the file imail_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: imail_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 11.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e21f66ba3e1ed874dfde4417ad0b45f336ea1d2691ce14bb884a090aacc3846
|
|
| MD5 |
dabdcc22747d5d004137f5a20a012049
|
|
| BLAKE2b-256 |
df71e2aa5e43b6134669d7ecd3d4f7c19e8fcf1e01fa19116e5c43f3ad6c3776
|
