← Back to Skills Marketplace
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install osascript-email
Description
Send automated plain-text emails on macOS via Mail.app using AppleScript without SMTP credentials, suitable for alerts and reports, not bulk or HTML emails.
Usage Guidance
This skill appears to do what it says (send Mail.app messages via AppleScript) but take precautions before installing: (1) Review and test the included scripts locally — the Python helper constructs AppleScript by interpolating user strings; avoid passing untrusted input as subject/body/to/attachment_path. (2) Be careful with attachments: supplying absolute paths lets the skill send arbitrary local files — do not give the agent broad file-system read access or allow autonomous runs that could pick sensitive files. (3) Limit Automation permissions and prefer user-invocable use (do not enable broad autonomous invocation) unless you trust the agent and inputs. (4) If you plan to use this from an automated agent, add input sanitization or stronger quoting to prevent AppleScript injection and carefully audit any cron/agent workflows that call send_email. Additional information that would raise confidence: a hardened escaping routine for AppleScript used in the helper, tests demonstrating safe handling of special characters, or an explicit note limiting agent file-access when used autonomously.
Capability Analysis
Type: OpenClaw Skill
Name: osascript-email
Version: 1.0.0
The skill provides functionality to send emails and attachments via macOS Mail.app using `osascript`. It is classified as suspicious due to weak input sanitization in `scripts/send_email.py` and `references/attachments.md`, which only perform basic escaping of double quotes and backslashes. This creates a vulnerability to AppleScript injection if the agent processes untrusted content for the email subject or body, potentially allowing unauthorized local automation commands beyond the stated purpose.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and included send_email.py all align: this is an AppleScript/osascript-based helper for Mail.app on macOS. No unrelated credentials, binaries, or cloud APIs are requested.
Instruction Scope
Runtime instructions tell the agent to construct and run AppleScript via osascript and provide a Python helper that builds an AppleScript string with user-supplied subject/body/to/attachment_path. The skill instructs use of absolute file paths for attachments (references/attachments.md). These patterns are expected for the task, but constructing AppleScript via naive string interpolation is brittle and can allow script injection or accidental execution of unintended AppleScript if inputs are not properly sanitized. Attachment guidance also enables sending arbitrary local files, which could be used to exfiltrate sensitive data if an agent has file access. The SKILL.md does warn about explicit consent and Automation permissions.
Install Mechanism
No install spec (instruction-only + single Python helper file). No downloading or execution of remote code; lowest-risk install pattern.
Credentials
The skill requests no environment variables or external credentials, which is proportionate. It does require Mail.app to be configured with an account and Automation permission to control Mail.app — these are legitimate for the stated purpose.
Persistence & Privilege
always is false and the skill does not request special persistent privileges or modify other skills. Note: the platform default allows autonomous invocation; combined with the ability to attach/send local files this increases risk if the agent is granted broad file or execution rights.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install osascript-email - After installation, invoke the skill by name or use
/osascript-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. Send email via macOS Mail.app using osascript — no SMTP credentials or API keys required. Includes Python helper, attachment reference, and troubleshooting guide.
Metadata
Frequently Asked Questions
What is osascript-email?
Send automated plain-text emails on macOS via Mail.app using AppleScript without SMTP credentials, suitable for alerts and reports, not bulk or HTML emails. It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.
How do I install osascript-email?
Run "/install osascript-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is osascript-email free?
Yes, osascript-email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does osascript-email support?
osascript-email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created osascript-email?
It is built and maintained by yumik20 (@yumik20); the current version is v1.0.0.
More Skills