# Apple Notes MCP Server
An MCP (Model Context Protocol) server for interacting with Apple Notes on macOS.
## Features
- List notes from all accounts or specific accounts/folders
- Search notes by content
- Read note content
- Create new notes
- Update existing notes
- Delete notes
- List available accounts
## Requirements
- macOS (uses AppleScript to interact with Notes app)
- Python 3.10+
- Notes app must be installed and accessible
## Notes
- The server uses AppleScript to interact with the Notes app
- You will need to grant Terminal/iTerm/Cursor *PERMISSION* to control Notes in System Preferences > Security & Privacy > Accessibility
- Account names are case-sensitive (e.g., "iCloud" vs "icloud")
## Installation
```bash
git clone https://github.com/arslankhanali/apple-notes-mcp.git
cd apple-notes-mcp
uv venv
source .venv/bin/activate
uv add "mcp[cli]"
# To run
# uv run apple_notes.py
```
## Usage with Cursor
Add to your MCP configuration (`~/.cursor/mcp.json`):
> Change `/path/to/apple-notes-mcp` to where you cloned this repo
```json
{
"mcpServers": {
"apple-notes": {
"command": "uv",
"args": [
"--directory",
"/path/to/apple-notes-mcp",
"run",
"apple_notes.py"
]
}
}
}
```
## Available Tools
- `list_notes` - List all notes or notes from a specific account/folder
- `search_notes` - Search for notes containing specific text
- `read_note` - Read the content of a specific note
- `create_note` - Create a new note with title and content
- `update_note` - Update the content of an existing note
- `delete_note` - Delete a note
- `list_accounts` - List all available Notes accounts