apple-notes-mcp

apple-notes-mcp

PythonMacosMcpClaudeAppleNotesContextProtocolUvJavascriptGoRubyR

About This Server

Read your Apple Notes with Claude Model Context Protocol

Server Information

šŸ“‹ Overview:

This webpage is a GitHub repository page for a project named "apple-notes-mcp" by user sirmews. It is designed to read Apple Notes data and provide it to Claude Desktop, allowing Claude to search through the user's notes. The project is licensed under the MIT License.


ā­ Key Points:
  • Project Name: apple-notes-mcp

  • Author: sirmews

  • Description: Reads Apple Notes and provides it to Claude Desktop.

  • License: MIT License

  • Tools provided: get-all-notes, read-note, and search-notes.

  • Relies on the Model Context Protocol (MCP).

  • Recommends using uv for installation.

  • Requires MacOS full disk access due to the location of the Apple Notes database.


  • šŸ” Main Findings:
  • The project aims to enhance Claude's contextual awareness by feeding it Apple Notes data.

  • It is a server implementing specific protocols for reading and writing Apple Notes.

  • Several features are currently missing, such as encrypted notes, cloud sync status, and attachment content retrieval.


  • šŸ“Š Details:
  • Installation:

  • uvx apple-notes-mcp or uv pip install apple-notes-mcp

  • Configuration involves modifying Claude's claudedesktopconfig.json:

  • For Development/Unpublished Servers

  • For Published Servers

  • Debugging is suggested using the MCP Inspector (npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp)


šŸŽÆ Conclusion:
The "apple-notes-mcp" project enables Claude Desktop to access and utilize a user's Apple Notes, potentially enhancing its functionality with personal information. The project is in active development, with plans to address missing features and improve overall utility.

Server Features

get-all-notes

Get all notes.

read-note

Get full content of a specific note.

search-notes

Search through notes.

Provider Information

Sirmews logo

Sirmews

cloud Provider

Visit Provider Website

Quick Actions

Visit Website

MCP Configuration

Available Resources

Apple Notes