mcp-apple-notes

Apple Notes MCP Server

Model Context Protocol（MCP）を使用して Apple Notes を自動化する強力なツール

mcp-name: io.github.henilcalagiya/mcp-apple-notes

概要

Apple Notes MCP Server は、Apple Notes とあらゆる MCP 対応クライアントをシームレスに連携します。シンプルで安全な AppleScript API レイヤーを通じて、ノートの作成、読み取り、更新、削除など、ノートの自動化をすべて実現します。

特長

• Apple Notes の 完全な CRUD 対応（作成、読み取り、更新、削除）
• Continue.dev、Claude Desktop、Perplexity、その他の MCP クライアントで動作
• 信頼性の高い macOS 自動化を実現する ネイティブの AppleScript 統合
• Apple Notes の自動化に役立つ 包括的なツール
• uvx による 自動インストール、または手動セットアップに対応
• モダンなデコレーター方式 API を採用した FastMCP の実装

要件

• macOS - AppleScript のサポートに必要です
• Python 3.10+ - MCP SDK との互換性に必要です
• Apple Notes アプリケーション - インストール済みで、アクセス可能である必要があります
• MCP 対応クライアント（例：Continue.dev、Claude Desktop）

クイックスタート

ステップ 1：uv をインストールする（まだインストールされていない場合）

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

代替方法（pip）：

pip install uv

ステップ 2：MCP の設定を追加する

この設定を MCP クライアントに追加します。

Perplexity、Cursor、Continue.dev、Claude Desktop の場合：

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

🎉これで完了です！ MCP クライアントは必要に応じてパッケージを自動的にインストールして実行します。

注： MCP クライアントが Apple Notes へのアクセスと、システム環境設定 → セキュリティとプライバシー → プライバシー → アクセシビリティでの AppleScript コマンド実行を許可されていることを確認してください。

利用可能なツール

ノート管理（6 ツール）

• create_note - HTML コンテンツを含むノートを作成します
• read_note - ID でノートを読み取り、検証します
• update_note - ID でノートを更新し、HTML コンテンツを設定します
• delete_note - ID でノートを削除し、検証します
• move_note - フォルダー間でノートを移動します
• list_all_notes - すべてのフォルダーにあるノートを一覧表示します

フォルダー管理（5 ツール）

• create_folder - パスを指定してフォルダーを作成します
• read_folder - ID でフォルダーの詳細を読み取ります
• rename_folder - ID でフォルダーの名前を変更します
• delete_folder - ID でフォルダーを削除します
• move_folder - フォルダーを別の場所に移動します

検索と構造（3 ツール）

• search_notes - キーワードでノートを検索します
• list_folder_with_structure - フォルダー階層を表示します
• list_notes_with_structure - フォルダーとノートの階層を表示します

コンテンツのサポート

HTML の書式設定：<h1-h6>、<b><i><u>、<p><div><br>、<ul><ol><li>、<table>、<a>

特別な機能：

• Unicode と絵文字に対応（🚀、✅、📝）
• 入れ子になったフォルダーパス（最大 5 階層）
• 文字を自動的にエスケープ
• 見出し、リスト、表を含むリッチコンテンツ

アーキテクチャ

このサーバーは MCP プロトコル仕様に準拠し、モジュール式アーキテクチャで構築されています。

• AppleScript レイヤー - Apple Notes との直接的なやり取りを処理します
• ツールレイヤー - AppleScript の操作を MCP ツール向けにラップします
• FastMCP サーバーレイヤー - デコレーターを使用して MCP プロトコルを実装します

トラブルシューティング

よくある問題

1. 「No module named 'mcp'」エラー

   • 自動インストールには uvx を使用してください
   • uv がインストールされ、PATH に含まれていることを確認してください

2. AppleScript のアクセス許可が拒否される

   • システム環境設定 → セキュリティとプライバシー → プライバシー → アクセシビリティで、ターミナルまたは MCP クライアントにアクセス許可を付与してください

3. ノートが見つからない

   • Apple Notes アプリがインストールされ、アクセス可能であることを確認してください
   • デフォルトの場所にノートが存在することを確認してください

ライセンス

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

Author

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

Support & Contributions:

• 🐛 Report Issues: GitHub Issues
• 💬 Questions: Reach out on LinkedIn
• 🤝 Contributions: Pull requests welcome!