← Back to Skills Marketplace
Mail
macos-suite-readonly
by
MaxStormSpace
· GitHub ↗
· v0.1.0
324
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install macos-suite-readonly
Description
macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。
README (SKILL.md)
macos-suite-readonly
面向 ClawHub 的“只读”macOS 查询技能：读取邮件未读、日程、备忘录搜索、股票行情。所有命令输出单个 JSON，适合 agent 解析。
⚠️ 权限
- 首次调用可能弹出系统权限提示（自动化/隐私）。
- 若系统拒绝自动化权限，命令会返回
ok=false或warning。
使用方式
python3 {baseDir}/scripts/main.py \x3Ccommand> key=value key=value ...
Commands
python3 {baseDir}/scripts/main.py mail.unread_count
python3 {baseDir}/scripts/main.py mail.unread_list limit=20
Calendar
python3 {baseDir}/scripts/main.py calendar.today limit=50
python3 {baseDir}/scripts/main.py calendar.list start="2026-03-03 00:00:00" end="2026-03-03 23:59:59" limit=50
Notes
python3 {baseDir}/scripts/main.py notes.folders
python3 {baseDir}/scripts/main.py notes.search query="购物" limit=10 folder="Notes"
Stocks
python3 {baseDir}/scripts/main.py stocks.quote symbol=AAPL
python3 {baseDir}/scripts/main.py stocks.quote symbol=600519
python3 {baseDir}/scripts/main.py stocks.batch symbols="AAPL,600519,00700"
Usage Guidance
This skill appears to do what it says. Before installing: (1) be aware it will access your Mail, Calendar, and Notes via AppleScript and macOS will likely prompt you to allow automation/access — only grant that if you trust the skill. (2) Stock data is fetched from qt.gtimg.cn; if you need a different provider, review/modify the script. (3) The full Python script is bundled (scripts/main.py) — review it yourself if you have concerns. (4) Because the agent can call the skill autonomously, consider whether you want an agent to be able to read your local Mail/Notes/Calendar without additional controls.
Capability Analysis
Type: OpenClaw Skill
Name: macos-suite-readonly
Version: 0.1.0
The skill is designed for read-only queries on macOS applications (Mail, Calendar, Notes) and stock data. The `SKILL.md` instructions are clear and do not contain any prompt injection attempts. The `scripts/main.py` uses `osascript` for macOS automation, passing user inputs as arguments which are treated as data within the AppleScripts, not executable code, and crucially, none of the AppleScripts use `do shell script`. Network access is strictly allowlisted to `qt.gtimg.cn` for stock quotes, preventing data exfiltration to arbitrary domains. No evidence of credential theft, persistence, or other malicious activities was found.
Capability Assessment
Purpose & Capability
Name/description promise read-only macOS queries (Mail unread, Calendar, Notes, Stocks). Declared OS=d arwin and required binaries (python3, osascript) are exactly what the code uses. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md only instructs running the included Python script with command-style args. The script uses osascript to read Mail, Calendar, and Notes (consistent with description) and performs HTTP GETs only for stock data. It does not read arbitrary filesystem paths or environment variables beyond expected runtime needs. Note: accessing Mail/Notes/Calendar will trigger macOS automation/privacy prompts.
Install Mechanism
No install spec; this is instruction-only with the Python script bundled. Nothing is downloaded or extracted from external URLs during install, so installation risk is low.
Credentials
No environment variables or credentials are required. The script accesses local user data via AppleScript (which is proportional to the skill's purpose). It makes outbound requests only to an allowlisted domain (qt.gtimg.cn) for stock quotes.
Persistence & Privilege
always is false and the skill does not request persistent system changes or modify other skills. disable-model-invocation is default (agent may call the skill autonomously), which is normal; this combined with local data access is a privacy consideration but not an incoherence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install macos-suite-readonly - After installation, invoke the skill by name or use
/macos-suite-readonly - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial public read-only macOS suite (Mail/Calendar/Notes/Stocks).
Metadata
Frequently Asked Questions
What is macos-suite-readonly?
macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。 It is an AI Agent Skill for Claude Code / OpenClaw, with 324 downloads so far.
How do I install macos-suite-readonly?
Run "/install macos-suite-readonly" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is macos-suite-readonly free?
Yes, macos-suite-readonly is completely free (open-source). You can download, install and use it at no cost.
Which platforms does macos-suite-readonly support?
macos-suite-readonly is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created macos-suite-readonly?
It is built and maintained by MaxStormSpace (@lilei0311); the current version is v0.1.0.
More Skills