apple-notes skill
scriptsPerform CRUD operations on Apple Notes to store and manage persistent information using HTML formatting.
- GitHub stars
- 14
- Files
- 5
- Last commit
- Dec 29, 2025
- License
- MIT
- Allowed tools
- —
What does the apple-notes skill do?
apple-notes is an agent skill. Perform CRUD operations on Apple Notes to store and manage persistent information using HTML formatting.
Summary generated from the skill's SKILL.md.
About the apple-notes skill
Managing persistent information and long-term memory within the Apple Notes application is what this skill enables. Developers can use these tools to ensure that ideas, data, or task lists survive beyond a single conversation session by storing them in an automatically created agent-notes folder. An agent should load this skill when a user requests to save a thought, create a reminder, or maintain reference material for future use.
The skill provides specific commands to list existing notes, read HTML content, create new entries, and delete notes by their title. When creating content, the tool uses HTML formatting for structure, supporting elements like headings, bold text, italics, and tables. To edit an existing note, the workflow requires reading the content, deleting the old note, and then creating a new one. While it handles text and tables well, it cannot programmatically add attachments or links, and it renders checklists as standard bulleted lists.
What an agent can do with it
- 1Store session dataSave important information or data that needs to be remembered across different chat sessions.
- 2Maintain task listsCreate and manage organized lists of tasks or reminders for the user.
- 3Organize structured notesGenerate formatted notes containing headings, bold text, or tables using HTML.
- 4Retrieve saved ideasRead the HTML content of a previously saved note to access stored thoughts.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the apple-notes skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the apple-notes skill in Plugin
/plugin marketplace add ALucek/apple-notes /plugin install apple-notes@apple-notes-marketplace
Install the apple-notes skill in Claude Code
~/.claude/skills/apple-notes/SKILL.md
$ npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes ~/.claude/skills/apple-notesInstall the apple-notes skill in Claude Code (project)
.claude/skills/apple-notes/SKILL.md
$ npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes .claude/skills/apple-notesInstall the apple-notes skill in Codex
~/.agents/skills/apple-notes/SKILL.md
$ npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes ~/.agents/skills/apple-notesInstall the apple-notes skill in Gemini CLI
~/.gemini/skills/apple-notes/SKILL.md
$ npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes ~/.gemini/skills/apple-notesInstall the apple-notes skill in Claude.ai
npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes apple-notes && zip -r apple-notes.zip apple-notes # claude.ai → Customize → Skills → + → Create skill → Upload a skill → apple-notes.zip
SKILL.md
View on GitHubApple Notes Creation & Editing
Overview
Tools to interact with Apple Notes. Notes are scoped to an automatically created agent-notes folder. Notes are formatted using HTML—supported elements are listed below.
When to Use
- Storing information that should persist across sessions
- Saving notes, ideas, or data the User wants to keep
- Creating task lists, reminders, or reference material
- When the User explicitly asks to save/remember something in notes
How to Use
- List existing notes to see what's available
- Read a note to get its HTML content
- Create new notes with HTML-formatted body
- Delete notes by title (to edit: read → delete → create)
Usage
# List notes
python scripts/list-notes.py
# Create note (heredoc for reliable input)
cat << 'EOF' | python scripts/create-note.py --title "My Note"
<div>Content here</div>
EOF
# Read note
python scripts/read-note.py --title "My Note"
# Delete note
python scripts/delete-note.py --title "My Note"
Note: The
--titleis automatically formatted as an<h1>header. Body content is piped via stdin using heredoc (<< 'EOF') to avoid shell escaping issues.
HTML Reference
| Element | HTML | Example |
|---|---|---|
| Title | <h1> |
<h1>Title</h1> |
| Heading | <h2> |
<h2>Heading</h2> |
| Subheading | <h3> |
<h3>Subheading</h3> |
| Paragraph | <div> |
<div>Text here</div> |
| Bold | <b> |
<b>bold</b> |
| Italic | <i> |
<i>italic</i> |
| Underline | <u> |
<u>underline</u> |
| Strikethrough | <strike> |
<strike>deleted</strike> |
| Monospace | <tt> |
<tt>code</tt> |
| Line break | <br> |
<br> |
| Bullet list | <ul><li> |
<ul><li>Item 1</li><li>Item 2</li></ul> |
| Numbered list | <ol><li> |
<ol><li>First</li><li>Second</li></ol> |
| Table | <object><table> |
See below |
Table Example
<object><table><tbody><tr><td>A</td><td>B</td></tr><tr><td>1</td><td>2</td></tr></tbody></table></object>
Limitations
- Checklists - Stored internally, checkbox state not accessible (renders as regular bullet list)
- Links - Stripped on save
- Highlights - Stored internally by Apple Notes
- Images - Technically possible (base64) but impractical for LLM use
- Attachments - Cannot be added programmatically
Files in this skill
5apple-notes skill questions
How do I install the apple-notes skill in Claude Code?
Run npx degit ALucek/apple-notes/plugins/apple-notes/skills/apple-notes ~/.claude/skills/apple-notes. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the apple-notes skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How are notes formatted in Apple Notes?
Notes are formatted using HTML, supporting elements like headings, paragraphs, bold, italic, lists, and tables.
Can I add images or attachments to notes via this tool?
No, attachments cannot be added programmatically, and while images are technically possible via base64, they are considered impractical for LLM use.
How do I edit an existing note?
To edit a note, you must first read the note, delete the existing one, and then create a new one.
Are hyperlinks supported in the notes?
No, links are stripped during the saving process.