{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_v5v7uxh65hz4","handle":"imail-mcp","url":"https://wellknown.network/agents/imail-mcp","links":{"self":"https://wellknown.network/agents/imail-mcp/record.json","html":"https://wellknown.network/agents/imail-mcp","markdown":"https://wellknown.network/agents/imail-mcp/record.md","api":"https://wellknown.network/api/v1/agents/imail-mcp","status":"https://wellknown.network/api/v1/agents/imail-mcp/status","claim":"https://wellknown.network/agents/imail-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/imail-mcp/claim.json","badge":"https://wellknown.network/agents/imail-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/imail-mcp/history","tools":"https://wellknown.network/api/v1/agents/imail-mcp/tools"},"ard":{"identifier":"urn:air::server:imail-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"imail-mcp","summary":"Agent-friendly Apple Mail.app CLI (imail): list, send, and auto-organize mail via AppleScript — no IMAP, no mail server config.","description":"# imail — Apple Mail CLI (+ agent schema)\n\n`imail` is an agent-friendly command line for **Apple Mail.app** — list your\ninbox, send mail, and auto-organize messages into folders, all without IMAP,\nhimalaya, or any mail server config. It drives Mail.app directly through\nmacOS Automation (AppleScript/`osascript`), so it needs nothing but Mail.app\nitself and the accounts already configured in it.\n\n```bash\nimail doctor\nimail list --limit 20\nimail organize --account work --limit 100\n```\n\nFor agent-friendly discovery, `imail -h` lists commands, `imail help` prints\nexamples, and `imail <command> -h` shows command options. Root options are\n`-V/--version`, `-j/--json`, and `-q/--quiet`; shell completion is intentionally\nnot exposed as framework-generated root flags.\n\n> **macOS only.** `imail` automates Mail.app via AppleScript, which only\n> exists on macOS, and requires the OS-level Automation permission grant\n> described below. There is no Linux/Windows build and none is planned —\n> the tool has nothing to talk to on those platforms.\n\n---\n\n## Install\n\n```bash\n# Homebrew\nbrew install ml-lubich/tap/imail\n\n# pipx (or uv, or pip)\npipx install imail-mcp          # or: uv tool install imail-mcp\n                                 # or: pip install imail-mcp\n\nimail -h\n```\n\n> The PyPI package is named `imail-mcp` (an older release also exists as\n> `mac-imail`); the installed command is always `imail`.\n\n<details>\n<summary>Developing on <code>imail</code> itself</summary>\n\n```bash\ngit clone https://github.com/ml-lubich/imail-mcp\ncd imail-mcp\nuv tool install .          # or: pip install -e \".[dev]\"\nimail -h\n```\n\nRun the test suite with `uv run pytest -q` (or install the `dev` extra with\n`pip install -e \".[dev]\"`). Tests use a sanitized account-wall fixture and do\nnot require the ignored, personal `accounts.json` file or Mail.app access. CI\nsets `NO_COLOR=1` so Rich help output stays stable in noninteractive runs.\n\n</details>\n\n---\n\n## Setup: grant Mail Automation permission\n\nThe first ti…","publisher":{"name":"ml-lubich","url":null},"homepage":"https://github.com/ml-lubich/imail-mcp","repository":"https://github.com/ml-lubich/imail-mcp","version":"0.2.1","license":"MIT","protocols":["mcp"],"tags":["agent","apple-mail","applescript","cli","macos","mail.app","mcp","typer"],"pricing":null,"endpoints":[{"url":"pypi:imail-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.688,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"imail-mcp","registry":"pypi","observedAt":"2026-10-28T07:25:58.306Z","publishedAt":"2026-10-25T21:39:14.891256Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"imail-mcp","url":"https://pypi.org/project/imail-mcp/","firstSeenAt":"2026-10-28T07:24:57.728Z","fetchedAt":"2026-10-28T07:24:57.728Z","normalizedAt":"2026-10-28T07:24:57.728Z"}]},"firstSeenAt":"2026-10-28T07:24:57.728Z","updatedAt":"2026-10-28T07:25:58.306Z"}