arslankhanali

Apple Notes MCP Server

by arslankhanali

生産性向上

Enables interaction with Apple Notes on macOS through AppleScript, allowing users to list, search, read, create, update, and delete notes across accounts and folders.

GitHubで見る

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

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

{
  "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