Apple Voice Memo MCP

🚀 Apple Voice Memo MCP Server

このサーバーは、macOS上のApple Voice MemosにプログラムからアクセスするためのMCP（Model Context Protocol）サーバーです。Claudeや他のAIアシスタントが音声録音データとやり取りできるようになります。

[whisper - mcp](https://github.com/jwulff/whisper - mcp) と組み合わせることで、ローカルでの文字起こしも可能です。

✨ 主な機能

• 音声メモの一覧表示 - メタデータ付きですべての音声メモを閲覧できます。
• メモの詳細情報取得 - 特定の録音データの詳細情報を取得できます。
• オーディオの取得 - オーディオファイルのパスまたはBase64エンコードされたオーディオデータにアクセスできます。
• 文字起こしの取得 - メモから文字起こしを抽出できます（Appleがオーディオファイル内に保存しています）。
• メモの文字起こし - AppleのSFSpeechRecognizerを使用して文字起こしを生成できます。

📦 インストール

npm install -g apple-voice-memo-mcp

または、npxを使って直接実行することもできます。

npx apple-voice-memo-mcp

📚 ドキュメント

Claude Desktop

Claude Desktopの設定ファイルに以下を追加します。 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

編集後、Claude Desktopを再起動します。

Claude Code (CLI)

Claude Codeの場合は、プロジェクトの .mcp.json ファイルに以下を追加します。

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

または、ユーザー全体の設定として、~/.claude/settings.json に追加します。

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

ヒント: Claude Codeで /mcp を使用して、サーバーが接続されていることを確認できます。

ローカル開発環境のセットアップ

npmではなくソースから実行する場合は、以下の設定を使用します。

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "node",
      "args": ["/path/to/apple-voice-memo-mcp/dist/index.js"]
    }
  }
}

権限設定

1. フルディスクアクセス：音声メモのデータベースを読み取るために必要です。
   • システム設定 > プライバシーとセキュリティ > フルディスクアクセスに移動します。
   • ターミナルアプリまたはClaude Desktopを追加します。
2. 音声認識（文字起こしの場合）：
   • transcribe_memo ツールを使用する場合のみ必要です。
   • 初回使用時にシステムがプロンプトを表示します。

💻 使用例

list_voice_memos

メタデータ付きですべての音声メモを一覧表示します。 パラメーター:

• limit (オプション): 最大結果数（1 - 100、デフォルト: 50）
• offset (オプション): ページネーションのオフセット
• search (オプション): タイトルでフィルタリングする検索語

応答例:

{
  "memos": [
    {
      "id": 1,
      "title": "Meeting Notes",
      "date": "2025-01-07T10:30:00.000Z",
      "duration": 120.5,
      "hasTranscript": true
    }
  ],
  "total": 15
}

get_voice_memo

特定のメモの詳細なメタデータを取得します。 パラメーター:

• id (必須): メモのID

get_audio

オーディオファイルを取得します。 パラメーター:

• id (必須): メモのID
• format (オプション): "path" または "base64"（デフォルト: "path"）

get_transcript

メモから文字起こしを抽出します。 パラメーター:

• id (必須): メモのID
• format (オプション): "text"、"json"、または "timestamped"

transcribe_memo

SFSpeechRecognizerを使用してメモを文字起こしします。 パラメーター:

• id (必須): メモのID
• language (オプション): 言語コード（デフォルト: "en - US"）

🔧 技術詳細

データアクセス

音声メモのデータは以下に保存されています。

• データベース: ~/Library/Group Containers/group.com.apple.VoiceMemos.shared/Recordings/CloudRecordings.db
• オーディオファイル: 同じディレクトリに .m4a 形式で保存されています。

文字起こしの保存

Appleは、カスタムMPEG - 4アトム tsrp を使用して .m4a オーディオファイル内に直接文字起こしを保存しています。このMCPサーバーはこれらのアトムを解析して文字起こしを抽出します。個別の文字起こしファイルは存在しません。

開発方法

# リポジトリをクローン
git clone https://github.com/jwulff/apple-voice-memo-mcp.git
cd apple-voice-memo-mcp

# 依存関係をインストール
npm install

# ビルド
npm run build

# 開発環境で実行
npm run dev

# MCPインスペクターでテスト
npm run inspector

トラブルシューティング

"Voice Memos database not found"

1. 音声メモアプリを少なくとも1回開いたことを確認します。
2. ターミナル/アプリケーションにフルディスクアクセス権限を付与します。
3. 音声メモのiCloud同期が有効になっているか確認します。

"No transcript available"

• macOS Sequoia+では、音声メモアプリでメモを開いて自動文字起こしをトリガーします。
• 古いmacOSバージョンでは自動文字起こしがサポートされていません。
• transcribe_memo ツールを使用して、SFSpeechRecognizerを介して文字起こしを生成します。

ネイティブモジュールのバインディングエラー

better_sqlite3.node バインディングが見つからないというエラーが表示された場合は、以下を実行します。

npm rebuild better-sqlite3

これにより、現在のNode.jsバージョン用にネイティブモジュールが再コンパイルされます。

📄 ライセンス

MIT