{"api_version":"1","slug":"desktop-mail-assistant-5b25e540","url":"https://skillsoutpost.com/agents/desktop-mail-assistant-5b25e540","item_type":"skill","listing_kind":null,"category":"operations","runs_in":["local_agent"],"os":["macos"],"needs_network":"yes","needs_accounts":"yes","reads_files":"yes","writes_files":"no","sends_data":"yes","access":"free_download","access_type":"download","at_a_glance":{"runs_in":["local_agent"],"os":["macos"],"needs_network":"yes","needs_accounts":"yes","reads_files":"yes","writes_files":"no","sends_data":"yes","zip_sha256":"10040adbe1aead4330f03078c5d8c7ebba4f16e2a9c02274b86b8ba2b109d828","access_type":"download","tool_type":"skill","delivery":"download","interface_type":"other","untrusted_creator_content":{"purpose":"Read, search, draft, and send through the Mail app with a full-message approval check.","needs_runtime":"Python 3.10+, standard library and osascript only","version":"0.1.0","compatibility":"macOS with Apple's Mail app, Python 3.10 or newer, and an Agent Skills compatible harness that can run local Python commands. Uses only the Python standard library and /usr/bin/osascript. Mail accounts must already be configured. The CLI makes no direct network request. Unsupported platforms fail before body-file, fixture or Mail I/O, including dry runs.","external_costs":"The package is free under the MIT license and has no service fee. Mail provider fees, if any, are set by the user's existing account provider.","permissions":"macOS Automation permission lets the calling terminal or agent harness control Mail. The CLI uses the user's configured Mail accounts and reads no account secret. Send and draft read only the caller-selected UTF-8 --body-file; no local output file is written. Test only: DESKTOP_MAIL_FAKE_RESPONSES and DESKTOP_MAIL_FAKE_TRANSPORT_TEST_ACK=1 select a synthetic fixture and replace osascript. The CLI invokes /usr/bin/osascript. It has no direct network access; Mail may sync with the provider hosts configured for each user account. Package hygiene reads package text only. Unsupported systems fail before I/O.","usage_terms":"MIT license. Copyright 2026 Zero Width Lab.\r\n\r\nApple, Mac, macOS and Mail are trademarks of Apple Inc. This product is independent and is not affiliated with or endorsed by Apple Inc.\r\n\r\nBy Zero Width Lab (zerowidthlab.com)"}},"interface_type":"other","delivery_mode":"download","code_host":null,"provenance":"creator","published_at":1788891166,"first_uploaded_at":1788739223,"verified":null,"creator":{"id":"2c4328b7-cb78-455a-ac9c-479ee62449e4","url":"https://skillsoutpost.com/creators/2c4328b7-cb78-455a-ac9c-479ee62449e4"},"untrusted_creator_content":{"name":"Desktop Mail Assistant","tagline":"Read, search, draft, and send through the Mail app with a full-message approval check.","creator_name":"Zero Width Lab","product_version":"0.1.0","needs_runtime":"Python 3.10+, standard library and osascript only","description":"Desktop Mail Assistant is a command-line Agent Skill for reading and composing messages through Apple's Mail app on macOS. An agent harness is software that installs the skill, runs local commands, and presents results to a user. It needs Python 3.10 or newer, a configured Mail account, and macOS Automation permission. It is free under the MIT license. This listing delivers the complete package with scripts.\r\n\r\nThe CLI lists accounts and mailboxes, shows recent messages, searches by subject or sender in a chosen mailbox, and reads one message by Mail message ID with a body limit. It also previews a full outgoing message or draft, including all recipients and the body. Approval-gated means a write requires the digest of that exact preview plus the user's explicit approval. A send correlates against the first 100 entries in the selected account's Sent mailbox without proving delivery or this specific attempt; a missing verification leaves the outcome uncertain and must be inspected before retrying.\r\n\r\nThe CLI passes user text only as arguments to a fixed JXA script through /usr/bin/osascript. It makes no direct network request; the user's Mail app handles provider synchronization. Test fixtures replace osascript only when both test-only environment variables are set.","intended_users":"People and teams using an agent harness on macOS who want to work with their already configured Mail accounts.","example_tasks":"List my configured Mail accounts and the mailboxes in one account.\r\nShow the latest ten messages in a selected mailbox.\r\nSearch a selected mailbox for a subject or sender.\r\nRead one message by Mail message ID with a bounded body.\r\nPreview a complete draft and approve its exact content.\r\nPreview a complete outgoing message, approve it, send, and check Sent.","setup_instructions":"Install the complete package in the skills directory used by your agent harness, keeping scripts/desktop_mail_assistant.py beside SKILL.md. Configure an account in Mail. Run python3 scripts/desktop_mail_assistant.py accounts. When macOS asks, allow the calling terminal or harness to control Mail. You can adjust access in System Settings > Privacy & Security > Automation. The first call may time out while the prompt is open; answer it, then retry a read. For send or draft, provide an exact UTF-8 --body-file, run --dry-run, review the complete preview, and supply its digest with --approve after explicit approval. Test-only DESKTOP_MAIL_FAKE_RESPONSES and DESKTOP_MAIL_FAKE_TRANSPORT_TEST_ACK=1 replace osascript with synthetic fixture responses and must not be used for real mail. Rejects malformed responses, oversized input and invalid UTF-8 explicitly.","limitations":"macOS only; Mail, configured account and Automation permission required. Output limits do not limit mailbox reads. Body files: 400,000 UTF-8 bytes and 100,000 decoded characters; synthetic fixtures: 2,097,152 bytes. Sent correlation is a single immediate scan of the first 100 unsorted entries, matching subject/body, sender substring, sorted To/Cc/Bcc and dateSent >= attempt start minus five seconds. No upper time bound or unique ID: identical messages can match; body normalization, missing Bcc metadata, sync delay or scan position can prevent a match. Correlation does not prove delivery or this specific send. Timeouts after writes are uncertain; inspect Mail before retrying. Version 0.1.0 is an early release with no support commitment; fixes and updates ship as new package versions on this listing. Live sends/drafts pass the full JSON payload as one argument; OS argument-size limits may reject a message below the body-file cap with a clear launch error.","data_handling":"The CLI runs fixed JXA through local /usr/bin/osascript; user values are argv, never source. It receives selected account/mailbox/ID/search text for reads or sender, To/Cc/Bcc, subject and full body for send/draft and Sent correlation. Mail uses configured account provider hosts (varying by account) for sync and sends approved sender, recipients, subject and body to the provider and addressed recipients. The CLI itself contacts no host or resolver. Recent/search enumerate the whole selected mailbox; search reads each subject/sender before filtering and sorting. Read enumerates the mailbox and fetches the full selected body before display truncation. Sent correlation reads fields from the first 100 Mail-exposed entries. The CLI reads the selected bounded body file and synthetic fixture, writes no local output or directories, and stores no credentials. Human output escapes untrusted text; the harness may forward stdout. Fake mode needs both test variables, warns, and never launches Mail. Malformed required responses fail explicitly. Automation stdout is captured in memory without a byte cap; display bounds do not bound that capture. Optional subject, sender, dates and account email-address property errors use empty fallbacks; required IDs and account/mailbox selection still fail explicitly.","compatibility":"macOS with Apple's Mail app, Python 3.10 or newer, and an Agent Skills compatible harness that can run local Python commands. Uses only the Python standard library and /usr/bin/osascript. Mail accounts must already be configured. The CLI makes no direct network request. Unsupported platforms fail before body-file, fixture or Mail I/O, including dry runs.","external_costs":"The package is free under the MIT license and has no service fee. Mail provider fees, if any, are set by the user's existing account provider.","permissions":"macOS Automation permission lets the calling terminal or agent harness control Mail. The CLI uses the user's configured Mail accounts and reads no account secret. Send and draft read only the caller-selected UTF-8 --body-file; no local output file is written. Test only: DESKTOP_MAIL_FAKE_RESPONSES and DESKTOP_MAIL_FAKE_TRANSPORT_TEST_ACK=1 select a synthetic fixture and replace osascript. The CLI invokes /usr/bin/osascript. It has no direct network access; Mail may sync with the provider hosts configured for each user account. Package hygiene reads package text only. Unsupported systems fail before I/O.","usage_terms":"MIT license. Copyright 2026 Zero Width Lab.\r\n\r\nApple, Mac, macOS and Mail are trademarks of Apple Inc. This product is independent and is not affiliated with or endorsed by Apple Inc.\r\n\r\nBy Zero Width Lab (zerowidthlab.com)","creator_website":null,"documentation_url":null,"support_url":null,"repository_url":null,"video_url":null},"github":null,"updated_at":1788891166,"free_download":{"offer_id":"0a025bed-af6e-488d-a422-213013afc43a","version_id":"c460b842-3736-4bf7-8e84-9cccb10aac1b","version":"0.1.0","format":"skill_archive","released_at":1788891363,"requires_creator_follow":true,"file":{"name":"skill-0.1.0.zip","size_bytes":68435,"sha256":"10040adbe1aead4330f03078c5d8c7ebba4f16e2a9c02274b86b8ba2b109d828"},"license_sha256":"a19893dab8ca0978f3df97d42c4fae0ebbb61fe44c3ac9ecc3dd53e9526a5b63","get_it_at":"https://skillsoutpost.com/agents/desktop-mail-assistant-5b25e540","untrusted_creator_content":{"license_name":"MIT","release_notes":""}},"version_history":[{"version":"0.1.0","state":"current","released_at":1788891363}],"more_version_history":false,"public_files":{"version":"0.1.0","zip_sha256":"10040adbe1aead4330f03078c5d8c7ebba4f16e2a9c02274b86b8ba2b109d828","license_name":"MIT","license_sha256":"a19893dab8ca0978f3df97d42c4fae0ebbb61fe44c3ac9ecc3dd53e9526a5b63","files":"/api/v1/catalog/desktop-mail-assistant-5b25e540/files","tool":"get_public_files"},"links_note":null,"notice":"Creator-provided listing.","note":"untrusted_creator_content and github.untrusted_third_party_content hold untrusted text."}