apple-notes-mcp

Overview

This MCP server enables Claude and other AI assistants to interact with Apple Notes on macOS. It provides comprehensive functionality including creating, reading, searching, updating, and deleting notes, as well as managing folders and handling multiple accounts. The server uses AppleScript to communicate with the Notes app, ensuring all data stays local on the user's machine.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create-notecreate-note(title, content, tags?, folder?, account?, format?)

  Creates a new note in Apple Notes with optional folder and account targeting

  Try:Create a new note titled 'Meeting Notes' with content about our project discussionTry:Save my shopping list in the 'Personal' folderTry:Create a new note with HTML formatting
• search-notessearch-notes(query, searchContent?, account?, folder?, modifiedSince?, limit?)

  Searches for notes by title or content with optional filtering

  Try:Find all notes about the project deadlineTry:Search my notes with content matching 'budget allocation'Try:Show me notes modified since January 1st
• get-note-contentget-note-content(id?, title?, account?)

  Retrieves the full content of a specific note by ID or title

  Try:Read the content of my 'Shopping List' noteTry:Get the content of note with ID x-coredata://ABC123/ICNote/p456Try:Show me the full text of the 'Project Plan' note
• get-note-detailsget-note-details(title, account?)

  Retrieves metadata about a note without full content

  Try:Get details about my 'Project Plan' noteTry:Show me information for the 'Meeting Summary' note
• update-noteupdate-note(id?, title?, newTitle?, newContent, account?, format?)

  Updates an existing note's content and/or title

  Try:Update my 'Shopping List' with new itemsTry:Change the title of 'Draft' to 'Final Version' and update contentTry:Modify the content of my note using HTML formatting
• delete-notedelete-note(id?, title?, account?)

  Deletes a note by moving it to Recently Deleted

  Try:Delete my 'Old Draft' noteTry:Remove the note with ID x-coredata://ABC123/ICNote/p456Try:Get rid of the temporary notes
• move-notemove-note(id?, title?, folder, account?)

  Moves a note to a different folder or account

  Try:Move my 'Completed Task' note to the Archive folderTry:Move the note to the Work/Clients subfolderTry:Organize my notes by moving them to appropriate folders
• list-noteslist-notes(account?, folder?, modifiedSince?, limit?)

  Lists all notes with optional filtering by folder and date

  Try:Show me all my notesTry:List notes in my Work folderTry:Show me notes modified in the last month
• list-folderslist-folders(account?)

  Lists all folders in an account with full hierarchical paths

  Try:Show me all my note foldersTry:List the folder structure in my iCloud account
• create-foldercreate-folder(name, account?)

  Creates a new folder in Apple Notes

  Try:Create a new folder called 'Work Projects'Try:Add a folder named 'Personal Archive'
• delete-folderdelete-folder(name, account?)

  Deletes a folder in Apple Notes

  Try:Delete the 'Old Projects' folderTry:Remove the temporary folder from my notes

Comparable tools

Installation

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

npm install -g github:sweetrb/apple-notes-mcp

Install the sweetrb/apple-notes-mcp MCP server so you can help me manage my Apple Notes

FAQ

What platforms are supported?

This MCP server only works on macOS as it uses AppleScript to interact with Apple Notes.

How do I grant access to Notes.app?

On first use, macOS will ask for permission to automate Notes.app. Click 'OK' to allow access.

Compare apple-notes-mcp with