mcpField
A
apple-notes

apple-notes

github.com/khamel83Productivity166 installsUpdated today
Repository

About apple-notes

A skill that defines a reliable workflow for automating Apple Notes, intended for projects that read or write notes through scripts or the GUI. It emphasizes confirming account, folder, and note IDs, then verifying delivery from the resulting note and receipt.

Key features

  1. 01Confirm the target account, folder, and note ID
  2. 02Choose AppleScript or GUI based on the operation
  3. 03Read before editing and preserve existing content
  4. 04Verify by provider ID and save a receipt

Use cases

  1. 01Create a note in a specified folder
  2. 02Edit a note while preserving formatting and attachments
  3. 03Verify that an automated write reached the correct target

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/khamel83/penny --skill apple-notes

After installing, type/apple-notesin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/scripting.md

Details

From the project README

Read the project contract before automated writes or binding a new project. Keep targets and receipts project-owned.

  1. Resolve the requested account/folder and, for an edit, the existing note ID. Titles and folder names may repeat. Confirm IDs and container ancestry rather than choosing the first match or relying on the default account. Reuse the project's adapter if one exists.
  2. For a new caller, run the Notes probe in apple-effects-reliability, then read the actual requested folder/item. Account-count success proves reachability, not target access or delivered content.
  3. Use bounded AppleScript for supported operations, or native computer use for rich content, locked notes or an unsupported feature. Read Notes scripting details when using AppleScript. Create only the requested note in the confirmed folder; create a missing folder only when the request or project policy authorizes it.
  4. For append/edit, read the current body first and preserve existing content, attachments and formatting outside the requested change. If a full-body replacement cannot preserve these, use the GUI for the requested edit.
  5. Read the resulting note by provider ID and confirm its account/folder and requested text. For marked creates, also reconcile the operation marker. Save the project's receipt. On uncertain output, use the reliability skill before repeating the write.

Completion means the requested content is visible in the correct note/target and the receipt records that check. A script exit code, provider ID or open window alone is not delivery verification.

Comments

Markdown supported