# Connector Apple Notes

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

- **Type:** Skill
- **Install:** `agentstack add skill-sboghossian-mini-claude-for-legal-connector-apple-notes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sboghossian](https://agentstack.voostack.com/s/sboghossian)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sboghossian](https://github.com/sboghossian)
- **Source:** https://github.com/sboghossian/mini-claude-for-legal/tree/main/skills/connector/connector-apple-notes

## Install

```sh
agentstack add skill-sboghossian-mini-claude-for-legal-connector-apple-notes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sboghossian](https://github.com/sboghossian)
- **Source:** [sboghossian/mini-claude-for-legal](https://github.com/sboghossian/mini-claude-for-legal)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sboghossian-mini-claude-for-legal-connector-apple-notes
- Seller: https://agentstack.voostack.com/s/sboghossian
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.