📝 Apple Notes MCP Server

注意

積極的なメンテナンスは行われていません。自己責任でご利用ください！

📝 Apple Notes MCP サーバー

Apple Notes MCP Server は、自然言語を通じて Apple Notes をシームレスに操作できる Model Context Protocol サーバーです。Claude やその他の AI アシスタントを使って、ノートの作成、検索、取得を簡単に行えます！🎉

🎯 機能

• ノートの作成： タイトル、内容、タグを指定して新しいノートをすばやく作成できます 📝
• ノートの検索： 強力な検索機能を使ってノートを見つけられます 🔍
• 内容の取得： タイトルを指定してノートの全文を取得できます 📖
• iCloud 連携： iCloud Notes アカウントと直接連携します ☁️

🚀 はじめに

前提条件

1. Apple Notes アプリを設定済みの macOS
2. Node.js（バージョン 20.0.0 以上）
3. Yarn パッケージマネージャー

インストール

1. リポジトリをクローンします：

   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
   cd mcp-apple-notes
   

2. 依存関係をインストールします：

   yarn install
   

3. プロジェクトをビルドします：

   yarn build
   

4. サーバーを起動します：

   yarn start
   

5. Claude Desktop を設定します。claude_desktop_config.json を次のように更新します：

   {
     "mcpServers": {
       "apple-notes": {
         "command": "yarn",
         "args": ["start"],
         "cwd": "/path/to/mcp-apple-notes"
       }
     }
   }
   

   注： /path/to/mcp-apple-notes を、クローンしたリポジトリの実際のパスに置き換えてください。 初めてコマンドを実行する際、スクリプトによる Apple Notes へのアクセスを許可する必要がある場合があります。

MCP サーバーの初期化

サーバーが正常に起動すると、次のように表示されます：

Starting Apple Notes MCP server.

これでサーバーを使ってノートを操作できるようになります！🎉

🛠️ 使用方法

利用可能なツール

1. ノートの作成

   • 説明：Apple Notes に新しいノートを作成します
   • パラメーター：

     {
       title: string;      // ノートのタイトル
       content: string;    // ノートの内容
       tags?: string[];    // ノートの任意のタグ
     }
     

   • 応答例：

     Note created: My New Note
     

2. ノートの検索

   • 説明：タイトルを指定してノートを検索します
   • パラメーター：

     {
       query: string; // 検索クエリ
     }
     

   • 応答例：

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. ノートの内容を取得

   • 説明：特定のノートの全文を取得します
   • パラメーター：

     {
       title: string; // ノートの正確なタイトル
     }
     

   • 応答例：

     [ノートの全文]
     

📚 使用例

1. すばやくメモを取る

会議中やブレインストーミングの際にノートを作成します：

{
"title": "Team Meeting Notes",
"content": "Discussion points:\n1. Project timeline\n2. Resource allocation",
"tags": ["meetings", "work"]
}

2. 情報の検索

必要なときに特定のノートを検索します：

{
"query": "meeting"
}

3. 内容の確認

特定のノートの全文を取得します：

{
"title": "Team Meeting Notes"
}

⚡ 最良の結果を得るためのヒント

• Apple Notes アプリが iCloud と正しく連携するように設定されていることを確認してください
• 検索しやすくするため、内容が分かりやすいタイトルを付けてください
• 整理しやすくするため、ノートの作成時に関連するタグを付けてください

🔧 開発

このプロジェクトでは TypeScript を使用し、最新の ES モジュールのパターンに従っています。主なファイル：

• src/index.ts：サーバーの主要な実装
• src/services/appleNotesManager.ts：ノート管理の中核機能
• src/utils/applescript.ts：AppleScript 連携ユーティリティ

開発コンテナー

VS Code ユーザー向けに開発コンテナーの設定が用意されており、次の機能を利用できます：

• TypeScript と Node.js の環境
• コード整形用の Prettier
• 依存関係の自動インストール

📄 ライセンス

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

---

Apple Notes ユーザーのために ❤️ を込めて作成