osascript-email for Openclaw

A macOS-specific skill for sending emails via Mail.app using AppleScript, bypassing the need for SMTP credentials or API keys.

yumik20
v1.0.0
Apr 4, 2026
0
655
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install osascript-email

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install osascript-email using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is osascript-email?

The osascript-email skill leverages the native AppleScript capabilities of macOS to interface directly with the Mail.app application. This approach allows developers and AI agents to send emails silently without the burden of managing complex SMTP settings, passwords, or third-party API keys. It is an ideal solution for Openclaw Skills users who need a lightweight, reliable method to send communications directly from a local environment.

By utilizing the existing Mail.app configuration, the skill ensures that emails are sent from authorized accounts while maintaining a low-friction setup process. This is particularly useful for automation tasks where traditional email tools like sendmail or SMTP clients are either unconfigured or restricted by security policies.

osascript-email Use Cases

  • Sending automated daily standup reports or system alerts from a local machine.
  • Triggering email notifications from cron jobs or local agent workflows.
  • Communicating via email when SMTP tools or command-line clients are unavailable.
  • Integrating email capabilities into macOS-based productivity and automation scripts.

How osascript-email Works

  1. The skill initiates an AppleScript process targeting the native Mail.app application.
  2. A new outgoing message object is created with specific properties including subject, body content, and visibility settings.
  3. Recipient addresses are added to the message object as distinct 'to' or 'cc' entities.
  4. The script executes the send command, which passes the message to the Mail.app background process.
  5. Mail.app handles the actual transmission using the user's pre-configured SMTP or IMAP accounts.

osascript-email Setup

To use this skill within the Openclaw Skills ecosystem, ensure your macOS environment is prepared:

  1. Confirm Mail.app is installed and configured with at least one active email account.
  2. Grant Automation permissions in System Settings > Privacy & Security > Automation for the terminal or app running the script.
  3. Test the setup using a simple bash command:
osascript << 'APPLESCRIPT'
tell application "Mail"
  set m to make new outgoing message with properties {subject:"Test", content:"Hello from Openclaw Skills", visible:false}
  tell m
    make new to recipient with properties {address:"[email protected]"}
  end tell
  send m
end tell
APPLESCRIPT

osascript-email Data Schema & Taxonomy

The skill interacts with the AppleScript Mail dictionary using the following data structure:

Property Description Format
subject The subject line of the email String
content The plain-text body of the email String
recipient The primary email address (To) String
cc Carbon copy email address String
visible Whether the Mail.app window appears Boolean
sender The account address in Mail.app String

osascript-email Advanced Features

  • Support for multiple recipients by adding iterative recipient blocks within the AppleScript logic.
  • Python helper integration for seamless inclusion in sophisticated AI agent workflows and scripts.
  • Silent background execution by setting the visibility property to false, preventing UI pop-ups.
  • Robust error handling for common macOS issues like missing permissions or unconfigured accounts.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*