local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows reading from and interacting with Apple Notes database, including retrieving all notes, reading specific note content, and searching through notes
Integrates with the macOS file system to access Apple Notes database, requiring Full Disk Access permissions

Claude デスクトップ用の Apple Notes モデルコンテキストプロトコルサーバー。

ローカルの Apple Notes データベースを読み取り、Claude Desktop に提供します。

クロードは、あなたが最も忘れていたメモを検索し、あなたについてさらに多くのことを知ることができるようになりました。

間違いが起こる可能性はありません。

コンポーネント

リソース

サーバーは、Apple Notes の読み取りと書き込みの機能を実装します。

ツール

サーバーは複数のプロンプトを提供します:

get-all-notes : すべてのノートを取得します。
read-note : 特定のノートの完全な内容を取得します。
search-notes : ノートを検索します。

欠けている機能:

暗号化されたメモは処理されません (ZISPASSWORDPROTECTED)
ピン留めされたノートのフィルタリングはサポートされていません
クラウド同期ステータスの処理なし
添付ファイルのコンテンツを取得できません
チェックリストステータス (ZHASCHECKLIST) はサポートされていません
メモを作成または編集する機能はありません

クイックスタート

サーバーをインストールする

Claude 用にサーバーをローカルにインストールするには、 uvを使用することをお勧めします。

uvx apple-notes-mcp

または

uv pip install apple-notes-mcp

以下の説明に従って設定を追加します。

クロードデスクトップ

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

注意: uvへの直接パスを使用する必要があるかもしれません。which which uvを使ってパスを見つけてください。

開発/非公開サーバーの構成

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

公開サーバーの構成

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

Mac OS ディスクアクセス権

サーバーにフルディスクアクセスを許可する必要があります。これは、Apple NotesのSQLiteデータベースがmacOSファイルシステムの奥深くにネストされているためです。

これがさらに私を悩ませる場合、または Apple Notes に追加/追記を開始したい場合は、将来 AppleScript ソリューションを検討する可能性があります。

発達

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

PyPI に公開:

uv publish

注: 環境変数またはコマンドフラグを使用して PyPI 資格情報を設定する必要があります。

トークン: --tokenまたはUV_PUBLISH_TOKEN
またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

ソースコード

ソースコードはGitHubで入手できます。

貢献

あなたのアイデアやフィードバックは、 Blueskyまたは問題をオープンして私に送ってください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AIがローカルのApple Notesデータベースから読み取ることを可能にします（macOSのみ）