Skip to content
MCP server

Apple Notes

MCP server to search, create and organise notes and folders in macOS Notes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.1.7
Listing updated
today

Similar MCP servers

About Apple Notes

Apple Notes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Notes stays the system of record here: the server drives the native Notes app through AppleScript so an agent can read, create, edit, move and delete notes without a separate store. Search results include the note plaintext, so queries match body text as well as titles and tags.

It copes with multiple accounts by listing accounts and folders first, and an allowed-accounts setting can restrict which ones it touches. Every AppleScript call has a timeout, 60 seconds by default, so a stalled Notes app cannot hang a request. If a create times out it returns NOTE_CREATE_STATUS_UNKNOWN and leaves matching notes alone, so you inspect the folder before retrying.

Safety modes are safe_readonly, safe_manage and full_access, and unlike its siblings it defaults to full_access. The README suggests keeping time-sensitive items in Reminders or Calendar instead.

Install

Run in a terminal

claude mcp add apple-mcp-notes -- uvx apple-mcp-notes

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-mcp-notes": {
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "apple-mcp-notes": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-mcp-notes"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APPLE_NOTES_MCP_SAFETY_MODESafety mode for Notes operations: safe_readonly, safe_manage, or full_access.
  • APPLE_NOTES_MCP_ALLOWED_ACCOUNTSComma-separated allow-list of Notes account names. Empty allows all accounts.
  • APPLE_NOTES_MCP_ALLOWED_FOLDERSComma-separated allow-list of Notes folder names. Empty allows all folders.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

search_tools
Lists available tools for context-constrained clients.
get_tool_info
Returns details for one tool.
notes_health
Checks Notes server health.
notes_permission_guide
Explains how to grant Notes automation access.
notes_recheck_permissions
Rechecks permissions after a macOS change.

What it does

Note CRUD
List, search, create, edit, move and delete notes.
Folder management
Create, rename and delete folders.
Attachment listing
Lists attachments on a note.
Body-text search
Search matches note plaintext, titles and tags.
Account allowlist
Limits which Notes accounts the server can use.
Script timeout
Bounded AppleScript calls, 60 seconds by default.

Good for

  • Save reference material from a chat into a folder
  • Search old notes by body text
  • Reorganise notes across folders
  • List recent notes for context
  • Rename or tidy folders

Pricing

Open source

Apple Notes FAQ

What permission does it need?

Automation access to Notes on macOS.

What is the default safety mode?

full_access, with safe_readonly and safe_manage available.

What happens if a create times out?

It returns NOTE_CREATE_STATUS_UNKNOWN and you should inspect the folder before retrying.

How do I install it?

Run uvx apple-mcp-notes.

Can locked notes be read?

Locked or unavailable note fields can come back empty.

Is Apple Notes free?

Yes. Apple Notes is open source, so you can use and self-host it for free.

How do I add Apple Notes to Claude Code?

Run this command in your terminal: claude mcp add apple-mcp-notes -- uvx apple-mcp-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 Concord MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers