sweetrb/apple-notes-mcp/apple-notes
Trust tier 2
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
Use this skill when the user wants to interact with Apple Notes on macOS - creating, searching, reading, updating, deleting, organizing, or formatting notes and folders. This skill provides access to Apple Notes through MCP tools and includes safe formatting guidance.
Install
npx vskill@latest install sweetrb/apple-notes-mcp/apple-notesSKILL.md
Apple Notes Skill
This skill enables you to manage Apple Notes on macOS through natural language. Use it whenever the user mentions notes, wants to save information to Notes, or needs to retrieve, update, or organize their notes.
When to Use This Skill
Use this skill when the user:
- Wants to create a new note or save information
- Asks to find, search, or look up notes
- Wants to read the contents of a note
- Needs to update or edit an existing note
- Wants to delete or remove a note
- Asks to move or organize notes into folders
- Wants to list their notes or folders
- Mentions Apple Notes, Notes app, or "my notes"
Available Tools
Note Operations
| Tool | Purpose | |
|---|---|---|
create-note | Create a new note with title and content | |
search-notes | Find notes by title or content | |
query-notes | Find notes with a boolean expression over text, folders, tags, attachments, checklists, flags, word counts, and dates (reads the database; needs Full Disk Access) | |
get-note-content | Read the full content of a note | |
get-note-plaintext | Read a note's body as plain text (no HTML) | |
get-note-markdown | Read note content as Markdown | |
get-note-by-id | Get note metadata by ID | |
get-note-details | Get metadata (created, modified, account) | |
get-note-link | Get the shareable notes://showNote?identifier=… deep link for a note | |
update-note | Replace a note's whole body; refused when the note holds attachments, tables, checklists, or native tags, or formatting HTML cannot carry | |
append-to-note | Add content to a note without replacing it (position: "after" / "before", which inserts below the title) | |
append-native | Append plaintext, the native HTML subset, or Markdown to a note that holds native objects, without replacing its body (needs scopeText) | |
insert-link | Add one URL to a note as its raw text or as a labeled hyperlink, verified from the stored link | |
insert-note-link | Append a real link to another note (by id) with a static label, verified after the write | |
delete-note | Remove a note (moves to Recently Deleted; refuses a note already there, where delete is permanent); like update-note, append-to-note, and move-note it accepts ifFolderId, ifAncestorFolderId, and forbiddenAncestorFolderIds folder preconditions. For copy-then-retire, pass guardNoteId and expectedGuardContentHash (the verified copy's contentHash) so the original is deleted only while the copy is intact; needs Full Disk Access | |
batch-delete-notes | Delete multiple notes by ID (max 500 per call; refuses notes already in Recently Deleted) | |
move-note | Move a note to a different folder | |
batch-move-notes | Move multiple notes by ID (max 500 per call) | |
list-notes | List all notes or notes in a folder (excludes Recently Deleted unless includeRecentlyDeleted) | |
list-special-notes | List pinned notes, Quick Notes, Recently Deleted, or locked notes (kind; metadata only, needs Full Disk Access) | |
set-note-pinned | Pin or unpin one exact note (checks expectedPinned and expectedContentHash; never rewrites the body) | |
list-recent-notes | Changes since a cursor, oldest first, for incremental sync: pass since, then keep calling with nextSince until saturated is false (needs Full Disk Access) |
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/apple-notes/SKILL.md
Popularity
- Repository stars
- 68
- Repository forks
- 9
- 7-day trend score
- 21
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sweetrb/apple-notes-mcp/apple-notes)