Apple Notes FAQs

Name: Apple Notes
Author: bfeeny

Question 1

Are there any limitations to what the AI agent can do with Apple Notes?

Accepted Answer

Yes, there are some known limitations. The tool primarily handles text content and does not expose tags, rich text, tables, drawings, or pinned note status. It also cannot interact with password-protected notes, and large note libraries might experience slower performance.

Question 2

What specific actions can AI agents perform with Apple Notes using this tool?

Accepted Answer

AI agents can perform a wide range of actions including listing, reading, creating, updating, and deleting notes. They can also organize notes by listing and creating folders, move notes between folders, perform full-text searches across all notes, and list available Apple Notes accounts.

Question 3

What are the prerequisites for running the Apple Notes MCP Server?

Accepted Answer

To run the server, you need macOS, Node.js 18+ installed, and the Apple Notes.app. You will also need to grant macOS Automation permissions for your terminal application to control Apple Notes.

Question 4

What is the Apple Notes MCP Server?

Accepted Answer

The Apple Notes MCP Server is a tool that allows AI agents, such as Claude, to programmatically interact with and manage your Apple Notes on macOS. It uses AppleScript to automate the Notes.app, as Apple Notes does not have a native REST API.

Question 5

How do I integrate this tool with an AI agent like Claude?

Accepted Answer

You integrate it by configuring the MCP server in your Claude environment, such as Claude Desktop or Claude Code. This involves specifying the command and arguments to run the compiled JavaScript file, enabling your AI agent to access the defined Apple Notes tools.

Apple Notes

Apple Notes

Key Features

Use Cases

Key Features

Use Cases