---

name: connector-apple-notes
description: Use when a user wants to pull content from Apple Notes into a legal-AI workflow — for example, retrieving a meeting note to draft follow-up correspondence, attaching a note to a matter, or searching notes for a client name or clause fragment. Supports read-only access via iCloud Documents or the macOS native helper; no write-back to Apple Notes. Relevant across all jurisdictions for any practice area where lawyers take notes in Apple Notes.
license: MIT
metadata:
id: connector.apple-notes
category: connector
jurisdictions: [multi]
priority: P2
intent: [connector]
related: [connector-google-drive, connector-notion, connector-calendar, connector-gmail]
source: Louis — HAQQ Legal AI (github.com/sboghossian/mini-claude-for-legal)
version: "1.0"

Connector — Apple Notes

What it does

The Apple Notes connector surfaces note content stored in iCloud from the user's Apple Notes app and makes it available as context within legal-AI workflows. It is read-only: the connector can retrieve and search notes but does not create, edit, or delete notes in the Apple Notes application.

Typical uses in a legal context:

• Pulling a handwritten (transcribed) client intake note to auto-populate a matter summary.
• Searching for a prior meeting note by client name or keyword before drafting correspondence.
• Attaching note content to a matter workspace as background context.
• Reviewing a note taken during a site visit or court attendance to draft a factual narrative.

Setup / auth

Apple Notes does not expose a standard public OAuth API. Access is achieved via one of two mechanisms:

Option A — macOS native helper (preferred)

On a macOS device where the user is signed in with their Apple ID:

• A local helper process reads from the Apple Notes SQLite store (located at ~/Library/Group Containers/group.com.apple.notes/NoteStore.sqlite).
• No remote API call; no Apple ID credentials transmitted to external servers.
• Requires explicit user permission via macOS Privacy settings (Full Disk Access or Contacts access depending on macOS version).
• Works entirely offline.

This is the preferred method for law firms running on-premise or privacy-sensitive deployments.

Option B — iCloud Documents API (limited)

Apple exposes some iCloud Drive content via the CloudKit/iCloud Documents API, but Notes stored natively in Apple Notes are not accessible via CloudKit by third parties. This path is only viable if the user has exported notes to iCloud Drive as text or PDF files.

Practically: if the user's workflow involves exporting notes to a shared iCloud folder, the connector can read those files via iCloud Drive access — but this is a workaround, not a native integration.

Auth summary

Method	Auth required	Online?	Write access?
macOS native helper	macOS Privacy grant	No	No
iCloud Documents	Apple ID OAuth (limited)	Yes	No (read-only)

Capabilities

Capability	Status
List all notes (titles + snippets)	Supported (native helper)
Full-text search across notes	Supported
Retrieve full note content by title or ID	Supported
Retrieve notes from a specific folder/notebook	Supported
Read note attachments (images, PDFs)	Partial — text extraction only
Create or edit notes	Not supported
Delete notes	Not supported

Usage patterns

Pattern 1 — Retrieve note by client name before drafting

User: "Draft a follow-up email to Al-Hassan re our 14 May call"
→ Connector searches Apple Notes for "Al-Hassan" + date proximity
→ Returns matching note as context
→ Draft email references the note's key points

Pattern 2 — Attach notes to a new matter

When creating a new matter file, search Apple Notes for the client name and offer to import any matching notes as matter background. The user confirms which notes to attach before import.

Pattern 3 — Post-hearing notes to narrative

User: "Summarize my notes from yesterday's DIFC hearing"
→ Connector retrieves notes from yesterday (date-filtered)
→ Returns content for summarization
→ Output: structured hearing summary for matter file

Permissions & safety

• Read-only at all times. No write operations.
• On-device processing preferred. When using the macOS native helper, note content should not leave the device unless the user explicitly approves attaching content to an external system.
• PII handling. Apple Notes may contain highly sensitive client information — names, financial details, privileged communications. Treat every note as privileged until the user confirms otherwise.
• No background scanning. The connector must not proactively index all notes without explicit user initiation. Search is on-demand only.
• Audit log. Every note retrieval operation is logged with a timestamp and the user ID who triggered it.

Failure modes

Failure	Cause	Resolution
"No notes found"	Privacy permission not granted	Prompt user to grant Full Disk Access in System Settings → Privacy
Garbled content	Note contains handwriting/drawing (non-text)	Inform user; offer to transcribe image attachments if multimodal capability is available
Old/stale content	iCloud sync lag	Warn user that note content reflects the last successful iCloud sync; advise opening Notes.app to force sync
Notes from shared notebooks	Shared notebook content included	Surface shared-by attribution so the user knows the note's origin

Related skills

• [[connector-google-drive]]
• [[connector-notion]]
• [[connector-calendar]]
• [[connector-gmail]]