# Apple Notes

> |

- **Type:** Skill
- **Install:** `agentstack add skill-ryanwangfun-claude-skills-apple-notes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [RyanWangFun](https://agentstack.voostack.com/s/ryanwangfun)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [RyanWangFun](https://github.com/RyanWangFun)
- **Source:** https://github.com/RyanWangFun/claude-skills/tree/main/apple-integration/apple-notes

## Install

```sh
agentstack add skill-ryanwangfun-claude-skills-apple-notes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Apple Notes

Control macOS Notes.app with full CRUD operations and table support.

## Quick Reference

| Action | Script | Example |
|--------|--------|---------|
| List folders | `list_folders.applescript` | `osascript scripts/list_folders.applescript` |
| List notes | `list_notes.applescript` | `osascript scripts/list_notes.applescript "Notes"` |
| Read note | `get_note.applescript` | `osascript scripts/get_note.applescript "Notes" "笔记名"` |
| Create note | `create_note.applescript` | `osascript scripts/create_note.applescript "Notes" "标题" "内容"` |
| Update note | `update_note.applescript` | `osascript scripts/update_note.applescript "Notes" "笔记名" "新内容"` |
| Delete note | `delete_note.applescript` | `osascript scripts/delete_note.applescript "Notes" "笔记名"` |

## Scripts

Located in `scripts/` relative to this SKILL.md. Run with `osascript`:

```bash
# Get skill directory
SKILL_DIR="$SKILLS_DIR/apple-notes"

# List all folders
osascript "$SKILL_DIR/scripts/list_folders.applescript"

# List notes in folder
osascript "$SKILL_DIR/scripts/list_notes.applescript" "Notes"

# Get note content (by folder + name)
osascript "$SKILL_DIR/scripts/get_note.applescript" "Notes" "笔记名"

# Get note content (by ID)
osascript "$SKILL_DIR/scripts/get_note.applescript" "x-coredata://..."

# Create note
osascript "$SKILL_DIR/scripts/create_note.applescript" "Notes" "标题" "内容"

# Update note
osascript "$SKILL_DIR/scripts/update_note.applescript" "Notes" "笔记名" "新内容"

# Delete note
osascript "$SKILL_DIR/scripts/delete_note.applescript" "Notes" "笔记名"
```

## Creating Tables

Notes.app supports HTML tables. Create structured data like inventories:

```bash
osascript -e '
tell application "Notes"
    set htmlBody to "冰箱清单

物品数量备注
牛奶2周五过期
鸡蛋12
酸奶3草莓味
"
    make new note at folder "Notes" with properties {body:htmlBody}
end tell
'
```

## Natural Language Mapping

| User says | Action |
|-----------|--------|
| 查看/列出文件夹 | `list_folders.applescript` |
| 看看 X 文件夹 | `list_notes.applescript "X"` |
| 读取/查看笔记 Y | `get_note.applescript "folder" "Y"` |
| 创建/添加/记录笔记 | `create_note.applescript` |
| 更新/修改笔记 | `update_note.applescript` |
| 删除笔记 | `delete_note.applescript` |
| 创建表格/清单 | Use HTML table format |

## Notes

- Default folder: "Notes" (中文系统可能显示为其他名称)
- Content format: HTML (支持 ``, ``, ``, ``)
- Notes can be shared via iCloud for collaboration
- All scripts return JSON format for easy parsing

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [RyanWangFun](https://github.com/RyanWangFun)
- **Source:** [RyanWangFun/claude-skills](https://github.com/RyanWangFun/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ryanwangfun-claude-skills-apple-notes
- Seller: https://agentstack.voostack.com/s/ryanwangfun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
