sirmews/apple-notes-mcp logo

sirmews/apple-notes-mcp

Free

允许 AI 从本地 Apple Notes 数据库读取 (仅 macOS)。

FreeFree tier
Type
Open Source

About sirmews/apple-notes-mcp

An open-source Model Context Protocol (MCP) server that reads from the local Apple Notes database on macOS and provides the content to Claude Desktop. Claude can then search, retrieve, and access your notes, making forgotten information available during conversations. The server offers three tools: get-all-notes (list all notes), read-note (get full content of a specific note), and search-notes (search through notes). It requires Full Disk Access permission on macOS and is installed via uv or uvx. The repository is currently archived and no longer actively maintained. Known limitations include no support for encrypted notes, pinned notes, cloud sync status, attachments, checklists, or the ability to create or edit notes.

Key Features

Integrates with Claude Desktop via Model Context Protocol
Get all notes from your local Apple Notes database
Read full content of a specific note
Search through notes by content
Open source (MIT license)
Installable via uv or uvx

Pros & Cons

Pros
  • Free and open source with MIT license
  • Simple installation using uv/uvx package manager
  • Provides direct read and search access to local Apple Notes
  • Easy to configure with Claude Desktop
Cons
  • Mac only — requires Full Disk Access permission
  • Does not support encrypted (password-protected) notes
  • No ability to create or edit notes — read-only access
  • Cannot retrieve attachment content (e.g., images, PDFs)
  • No support for pinned notes filtering
  • Cloud sync status (iCloud) not handled

Best For

Let Claude access and search your personal Apple Notes for context during conversationsAutomatically retrieve notes to answer questions based on your stored informationIntegrate Apple Notes with AI assistants for note-based workflows

FAQ

Which operating systems are supported?
Only macOS is supported because Apple Notes uses a local SQLite database that requires Full Disk Access.
Can this tool create or edit notes?
No, it is read-only. It currently only provides get-all-notes, read-note, and search-notes tools.
How do I install apple-notes-mcp?
Install using uv: 'uvx apple-notes-mcp' or 'uv pip install apple-notes-mcp', then add the configuration to your Claude Desktop config file.
Is this tool free?
Yes, it is open source under the MIT license and free to use.
What permissions does it require?
You must grant Full Disk Access to the server so it can read the Apple Notes database, which is located deep in the macOS file system.