# Apple Notes

> Apple Notes is an MCP server for knowledge and memory. Search, read and write Apple Notes on a Mac, with edits off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/notes
- **MCP Registry name:** io.github.mgcrea/mcp-apple-notes
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

Notes can be limited to specific accounts: APPLE_NOTES_ACCOUNTS restricts every read and write by account name, and attachments can only be saved into one directory (default ~/Downloads). Bodies are truncated at 262,144 bytes by default to protect the model's context window.

Eight read tools cover diagnostics, accounts, folders, notes, search, getting a note, listing and saving attachments. The five write tools, create_note, update_note, move_note, delete_notes and add_attachment, are registered only when APPLE_NOTES_ALLOW_WRITES=1; with it off they are invisible to the model. add_attachment is the only way to put an image into a note.

Two permissions matter: Automation for Notes is required for everything, while Full Disk Access enables search at scale and save_attachment; without it the server runs on the slower Apple Events path. MIT licensed, unofficial, macOS 26 or later.

## Features

- **Account allowlist:** Restrict reads and writes to named Notes accounts.
- **Read tools:** Browse folders, search and fetch notes.
- **Gated writes:** Create, update, move and delete exist only when enabled.
- **Attachment handling:** List and save attachments; add images with add_attachment.
- **Body size cap:** Truncates note bodies to protect context.

## Good for

- Search personal notes during an agent task
- Turn meeting notes into a summary
- Create a note from an agent after enabling writes
- Save an attachment from a note to Downloads

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-apple-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ]
    }
  }
}
```

## Tools

- `diagnostics`
- `list_accounts`
- `list_folders`
- `list_notes`
- `search_notes`
- `get_note`
- `list_attachments`
- `save_attachment`
- `create_note`
- `update_note`
- `move_note`
- `delete_notes`
- `add_attachment`

## FAQ

### What permissions are needed?

Automation for Notes for everything; Full Disk Access for search at scale and save_attachment.

### Can an agent delete notes by default?

No. Write tools are invisible unless APPLE_NOTES_ALLOW_WRITES=1.

### How do I limit which notes it sees?

Set APPLE_NOTES_ACCOUNTS to a comma-separated list.

### Is Apple Notes free?

Apple Notes is a paid product with a free trial.

### How do I add Apple Notes to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes

### What are the best alternatives to Apple Notes?

The closest alternatives to Apple Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/apple-notes-3
