← Back to Skills Marketplace
243
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install email-checker-by-entzai
Description
Automated email assistant for Apple Mail. Runs on a schedule, scores priority, drafts AI replies, and emails you a report. Manage your inbox from Telegram or...
README (SKILL.md)
Email Checker for Mac
Automated email assistant for Apple Mail on macOS. Runs on a schedule, scores your unread emails by priority, drafts AI replies, and sends you a report — so you can manage your inbox from Telegram or WhatsApp without ever opening Mail.app.
Installation
git clone https://github.com/entzclaw/email-checker-for-mac
cd email-checker-for-mac
bash setup.sh
Setup
The wizard handles everything:
- Auto-discovers your Mail.app accounts
- Prompts for name, report email, trusted senders
- Picks your LLM provider (LM Studio, Ollama, OpenAI, or skip)
- Tests the connection and writes
config/settings.json - Installs the crontab
Usage
# Run a manual check
python3 scripts/email/checker.py
# Send a reply
python3 scripts/email/send_reply.py \
--to [email protected] \
--subject "Re: Something" \
--content "Your reply here"
# Check logs
tail -f logs/email_check.log
OpenClaw Integration
Tell OpenClaw via Telegram or WhatsApp:
"Run the email checker now" "Send the draft reply to Alice" "Add @company.com to my trusted senders"
Supported LLM Providers
| Provider | Notes |
|---|---|
| LM Studio | Local or remote vLLM endpoint |
| Ollama | Local |
| OpenAI | Requires API key |
| None | Reports without AI drafts |
Requirements
- macOS (tested on Tahoe 26.3, Apple Silicon)
- Python 3
- Mail.app with at least one configured account
- Automation permission: System Settings → Privacy & Security → Automation → Terminal → Mail
Usage Guidance
Plain-language recommendations before you install:
- Confirm the missing AppleScript: The Python checker expects a get_unread_emails.scpt file (used to read unread Mail.app messages), but that .scpt is not present in the provided manifest. Ask the author or check the repository for that file; without it the checker will fail.
- Understand the privileges you must grant: setup.sh requires you to allow Terminal to control Mail.app and may ask for Full Disk Access if running from cron. That lets the scripts read and send email on your behalf — only grant this on a machine/account you trust for this purpose.
- Cron persistence: setup.sh installs a crontab entry so the checker runs on a schedule. If you prefer manual runs, decline crontab installation and run the script manually. If you do install cron, note the skill will run even when you are not actively using the agent.
- LLM API keys live on disk: If you select OpenAI or another remote LLM, the API key is stored in config/settings.json. Ensure that file is protected, not in source control, and rotate the key if you stop using the skill. Prefer local LLMs (LM Studio/Ollama) if you don't want keys sent to external APIs.
- Review AppleScript string interpolation and inputs: The code constructs AppleScript snippets using subject/to addresses and other fields. This is expected for AppleScript-based Mail control, but if you allow external inputs (via files or agent commands) ensure they are trusted to avoid injection-like issues.
- Test in an isolated account: Run the setup and test on a disposable macOS account or VM with a dedicated bot inbox (as suggested in README) before giving it access to your primary email.
If you want, I can: (a) search the repo for the missing get_unread_emails.scpt, (b) point out exact lines in the scripts that construct AppleScript or run subprocesses for a closer review, or (c) generate a checklist of settings/permissions to review on macOS before installation.
Capability Analysis
Type: OpenClaw Skill
Name: email-checker-by-entzai
Version: 1.1.1
The skill bundle is classified as suspicious due to a command injection vulnerability in `scripts/email/send_reply.py`, where the `--subject` argument is interpolated into an AppleScript string without sanitization, allowing for arbitrary code execution. The bundle also utilizes `osascript` to control Mail.app and modifies system persistence via `crontab` in `setup.sh`. While these capabilities are necessary for the stated purpose of an automated email assistant, the lack of input validation on externally influenced data (like email subjects) creates a significant security risk that could be exploited through indirect prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the included code: Python scripts use osascript to read Mail.app, score messages, draft replies, and send reports. Required binaries (python3, osascript) and Mail.app are appropriate. However, the code references a get_unread_emails.scpt AppleScript file used to fetch messages but that .scpt is not present in the provided file manifest — if actually missing the checker cannot fetch unread emails as described.
Instruction Scope
SKILL.md and setup.sh instruct the user to grant Terminal permission to control Mail.app (Automation) and possibly Full Disk Access, and to install a cron job. Those are necessary for the stated functionality but are high-privilege actions: the scripts will read mailbox contents and send messages via Mail.app. The README/SKILL.md also expect OpenClaw to edit config/settings.json directly; that gives the agent write access to runtime config. The instructions are fairly specific (not open-ended), but they do expand the agent's operational surface to persistent, privileged automation.
Install Mechanism
No external download/install spec is included; this is instruction-and-source bundled in the skill. The setup is local (setup.sh writes config and installs a crontab). There are no downloads from arbitrary URLs, package manager installs, or extract steps in the skill package — low install-mechanism risk.
Credentials
The registry metadata declares no required env vars. The interactive setup optionally requests an LLM API key (OpenAI or other) and stores it in config/settings.json (gitignored). Requesting API keys is proportionate to the LLM feature. Be aware the key is stored on disk in a file that the skill and any process with file access can read; OpenClaw edits that config as part of its integration, which could expose or change stored credentials.
Persistence & Privilege
setup.sh (the provided installer) will install a cron job to run the checker on a schedule and instruct the user to grant Terminal Automation/Full Disk Access. That creates persistent background activity outside the immediate agent invocation and gives Mail.app automation rights. The skill metadata does not set always:true, but the installed cron plus automation permissions increases the blast radius — review and approve these system-level changes before proceeding.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-checker-by-entzai - After installation, invoke the skill by name or use
/email-checker-by-entzai - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
- Updated documentation in README.md and SKILL.md for clarity and consistency.
- Refreshed metadata and configuration details in _meta.json.
- Made setup.sh adjustments to align with documentation updates.
v1.1.0
- Internal documentation cleaned up: removed DEVLOG, USER-EXPERIENCE, and WORKFLOW markdown files from the docs directory.
- README, meta, script, and setup files updated.
- No user-facing functionality changes in this release.
v1.0.0
Initial release of Email Checker for Mac:
- Automated assistant for Apple Mail on macOS, running on a schedule.
- Prioritizes unread emails, drafts AI replies, and emails you a report.
- Supports interaction via Telegram or WhatsApp through OpenClaw integration.
- Setup wizard auto-discovers accounts, configures options, and installs crontab.
- Compatible with LM Studio, Ollama, OpenAI, or no AI provider.
- Requires macOS, Python 3, and Mail.app.
Metadata
Frequently Asked Questions
What is Email Checker by EntzAI?
Automated email assistant for Apple Mail. Runs on a schedule, scores priority, drafts AI replies, and emails you a report. Manage your inbox from Telegram or... It is an AI Agent Skill for Claude Code / OpenClaw, with 243 downloads so far.
How do I install Email Checker by EntzAI?
Run "/install email-checker-by-entzai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Email Checker by EntzAI free?
Yes, Email Checker by EntzAI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Email Checker by EntzAI support?
Email Checker by EntzAI is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created Email Checker by EntzAI?
It is built and maintained by entzclaw (@entzclaw); the current version is v1.1.1.
More Skills