Apple Notes MCP Server

February 6, 2025 · View on GitHub

MacのメモアプリをModel Context Protocol (MCP)で操作するためのサーバー実装です。シンプルなAPIを通じて、AppleScriptによるメモアプリの操作を可能にします。

機能

  • メモの作成（create-note）
  • メモの検索（search-notes）
  • メモ内容の取得（get-note-content）

メモ作成のデモ動画

必要要件

  • macOS Ventura以降
  • Node.js v16以上
  • TypeScript 5.0以上
  • Claude Desktop App（MCPクライアントとして使用）

インストール

# リポジトリのクローン
git clone [repository-url]
cd apple-notes-mcp

# 依存パッケージのインストール
npm install

セットアップ

  1. プロジェクトのビルド
npm run build
  1. Claude Desktop Appの設定 ~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加：
{
  "mcpServers": {
    "apple-notes": {
      "command": "node",
      "args": ["/absolute/path/to/apple-notes/build/index.js"]
    }
  }
}

使用方法

  1. サーバーの起動
npm start
  1. Claude Desktop Appでの使用例
  • メモの作成: "メモを作成して: タイトル「会議メモ」、内容「今日の打ち合わせ内容」"
  • メモの検索: "「会議」というキーワードを含むメモを検索して"
  • メモの取得: "「会議メモ」の内容を表示して"

プロジェクト構成

apple-notes/
├── package.json        # プロジェクト設定
├── tsconfig.json      # TypeScript設定
├── src/
│   ├── index.ts       # エントリーポイント
│   ├── types.ts       # 型定義
│   ├── services/
│   │   └── AppleNotesManager.ts  # メモ操作の中核機能
│   └── utils/
│       └── applescript.ts        # AppleScript実行ユーティリティ
└── build/             # コンパイル済みファイル

注意事項

  • iCloudアカウントが設定されている必要があります
  • メモアプリへのアクセス権限が必要です
  • システムの負荷を考慮し、リクエストの頻度にご注意ください

謝辞

  • Anthropic社のClaude Desktop App チーム
  • MCP（Model Context Protocol）の開発チーム