---
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]]