Apple Notes MCP

🚀 苹果笔记モデルコンテキストプロトコルサーバー（Claude Desktop）

このサーバーは、あなたのローカルのApple Notesデータベースを読み取り、Claude Desktopに提供します。

これにより、Claudeはあなたが最も忘れがちなノートを検索し、あなたについてもっと多くのことを学ぶことができます。

✨ 主な機能

リソース

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

ツール

サーバーはいくつかのコマンドを提供しています。

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

🚧 未実装の機能

• 暗号化されたノート（ZISPASSWORDPROTECTED）の処理が未対応です。
• 固定ノートのフィルタリングはサポートされていません。
• クラウド同期状態の処理が未実施です。
• 添付ファイルの内容検索ができません。
• チェックリストの状態（ZHASCHECKLIST）のサポートがありません。
• ノートの作成や編集はできません。

🚀 クイックスタート

サーバーのインストール

Claudeで使用するために、uvを使ってこのサーバーをローカルにインストールすることをおすすめします。

uvx apple-notes-mcp

または

uv pip install apple-notes-mcp

以下に説明するように設定を追加してください。

Claude Desktop

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

注意：uvのパスを直接指定する必要がある場合があります。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のソリューションを検討することができます。

👨‍💻 開発

ビルドと公開

配布の準備をするには：

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

uv sync

2. リリース版をビルドします。

uv build

これにより、dist/ディレクトリにソースコードとパッケージが作成されます。 3. PyPIに公開します。

uv publish

注意：PyPIの認証情報は環境変数またはコマンドライン引数で設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdioを通じて実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspectorの使用を強くおすすめします。

以下のコマンドでMCP Inspectorを起動できます。

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

起動後、InspectorはブラウザでアクセスできるURLを表示し、デバッグを開始できます。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。

🌐 ソースコード

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

🤝 貢献の方法

あなたのアイデアやフィードバックをBlueskyに送るか、問題を開くことで投稿してください。