Apple Notes

You can automate Apple Notes using a dedicated MCP server that exposes note operations through a streamlined, secure interface. This server lets MCP clients create, read, update, delete, move, and search notes and folders on macOS with native AppleScript integration, enabling seamless automation across compatible MCP clients.

How to use

To use this MCP server, configure your MCP client to load the server via a local runtime that executes the package and exposes its endpoints. You can perform full CRUD operations on notes, manage folders, and run structured searches to organize your Apple Notes data. The server is designed to work with MCP clients such as Continue.dev, Claude Desktop, and other MCP-enabled apps, providing a consistent set of note and folder actions across environments.

How to install

Prerequisites: you need a macOS machine to access Apple Notes and run AppleScript. You also need Python 3.10 or newer for MCP SDK compatibility. Ensure you have an MCP-compatible client installed on your system.

Step 1: Install the runtime helper if it is not already installed on your system.

curl -LsSf https://astral.sh/uv/install.sh | sh

Alternative (Python-based): you can install the Python package runner if you prefer using pip.

pip install uv

Additional setup and configuration

The MCP configuration shown here loads the server by invoking the runtime with the package name at latest release. This integrates with MCP clients that support loading servers automatically.

{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["mcp-apple-notes@latest"]
    }
  }
}

Security and permissions

Grant your MCP client and terminal the necessary permissions to access Apple Notes and to execute AppleScript commands. On macOS, navigate to System Preferences > Security & Privacy > Privacy > Accessibility and enable access for the relevant applications. Ensure your Apple Notes data remains secure by limiting access to trusted MCP clients.

Troubleshooting

If you encounter issues, verify that you have the required macOS permissions for AppleScript, that Apple Notes is installed and accessible, and that your MCP client is configured to load the server correctly. Ensure the runtime (uvx) is installed and available in your PATH.

Notes

You can use a variety of tools to manage Apple Notes data through this MCP server. The setup supports HTML content for notes, folder hierarchies up to five levels deep, and structured representations of notes and folders.

Available tools

create_note

Create notes with HTML content.

read_note

Read notes by ID with verification.

update_note

Update notes by ID with HTML content.

delete_note

Delete notes by ID with verification.

move_note

Move notes between folders.

list_all_notes

List all notes across all folders.

create_folder

Create folders with path support.

read_folder

Read folder details by ID.

rename_folder

Rename folders by ID.

delete_folder

Delete folders by ID.

move_folder

Move folders between locations.

search_notes

Search notes by keywords.

list_folder_with_structure

Show folder hierarchy.

list_notes_with_structure

Show folders + notes hierarchy.