whispernotes

Whisper Notes MCP サーバー＆CLI

Whisper Notes に MCP サーバーおよびコマンドラインからアクセスできます。Mac と iPhone 向けのオンデバイス音声テキスト変換アプリです。Claude やあらゆる MCP クライアントから、文字起こし履歴の検索、文字起こしの読み取り（プレーンテキスト、タイムスタンプ付き、話者ラベル付き）、音声・動画ファイルの文字起こしを行えます。

100％オンデバイスで処理します。 サーバーはローカルの Unix ソケット（アクセス許可 0600）を介して通信するため、開放ポートもネットワークインターフェースもクラウドもありません。音声と文字起こしが Mac の外に出ることはありません。

MCP サーバーは Whisper Notes の Mac アプリに組み込まれているため、npx や pip install は必要ありません。このリポジトリはドキュメントとレジストリの拠点です。正式なドキュメントは whispernotes.app/cli-mcp にあります（エージェントが読み取れる Markdown 版：whispernotes.app/cli-mcp.md）。

セットアップ

1. Whisper Notes for Mac 1.5.5 以降をダウンロードします。ダイレクトダウンロード版（DMG）を使用してください。Mac App Store 版には Local API が含まれていません。macOS 14 以降、Apple Silicon が必要です。
2. アプリを開き、Settings → Integrations に移動して、Local CLI & MCP をオンにします。
3. 同じセクションで Install CLI をクリックすると、whispernotes（および、その名前が使用可能な場合は短縮名の wn）がターミナルにインストールされます。

Claude または任意の MCP クライアントを接続する

Claude Code — 1 行で設定できます。

claude mcp add whispernotes -- whispernotes mcp

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "whispernotes": {
      "command": "/usr/local/bin/whispernotes",
      "args": ["mcp"]
    }
  }
}

which whispernotes で確認したフルパスを使用してください。GUI アプリはシェルの PATH を読み取りません。その他のローカル MCP クライアント（Cursor など）も同様に動作します。コマンドは whispernotes、引数は ["mcp"] です。トランスポートは stdio で、HTTP エンドポイントはありません。

あとは、次のように尋ねるだけです。

• 「直近の文字起こしを5件読んで、フォローアップすべきことを教えてください。」
• 「請求書について話し合った会議を見つけて、返信メールの下書きを作成してください。」
• 「~/Desktop/podcast.mp3 を文字起こしして、すべてのアクションアイテムを抜き出してください。」

MCP ツール

ツール	パラメーター	戻り値
list_transcripts	limit（デフォルト 20） · source	ID、日付、タイトルを含む最近の文字起こし
search_transcripts	query（必須） · limit	スニペット付きの全文検索結果
get_transcript	id（必須） · timestamps · speakers · max_chars · offset	1件の文字起こしテキスト
get_latest_transcript	timestamps · speakers	最新の文字起こし
transcribe_file	path（必須）	音声または動画ファイルを文字起こしし、履歴に保存します
list_models	—	インストール済みモデルと現在アクティブなモデル

長時間の録音はページ分割されます。文字起こしが max_chars を超えると、レスポンスの末尾に明示的な切り詰めマーカーが付き、エージェントが次に読み取る offset を示します。1時間に及ぶ会議でもコンテキストウィンドウを超えることはありません。

CLI

同じバイナリで、フル機能のコマンドラインツールを利用できます。

$ whispernotes status
WhisperNotes 1.5.5 (340) · SenseVoice Small · ready · 3081 notes

$ whispernotes list --limit 3
9f3c21a8  2026-08-01 09:14  0:42   meeting   Weekly sync — pricing review
b2d84e07  2026-07-31 18:03  12:26  recorded  Idea dump on the walk home
5a1f9c33  2026-07-30 10:52  47:10  imported  interview-with-anna.m4a

$ whispernotes show latest | ollama run llama3 "Summarize the key points:"

$ whispernotes export --format md --audio --output-dir ~/Transcripts
✓ exported 312/312 transcript(s), 312 audio file(s) → /Users/you/Transcripts

コマンド	オプション	説明
status	—	アプリのバージョン、アクティブなモデル、準備状況、メモの件数
list	--limit N · --source T · --json	新しい順に最近の文字起こしを表示します
search <query>	--limit N · --json	履歴全体を全文検索し、スニペットを表示します
show [id or latest]	--timestamps · --speakers · --max-chars N · --offset N · --json	文字起こしを1件表示します（デフォルトは latest）
transcribe <file>	--json	音声ファイルまたは動画ファイルを文字起こしし、履歴に保存します
export	--format txt or md · --output-dir DIR · --source T · --limit N · --audio · --speakers	文字起こしを一括エクスポートします。音声も一緒にコピーするかどうかを指定できます
models	list · select <id>	モデルを一覧表示または切り替えます：parakeet、sensevoice、whisper-small、whisper-large-v3-turbo
language	list · select <code>	文字起こしの言語を一覧表示または切り替えます。選択肢はアクティブなモデルに応じて変わります
mcp	—	標準入出力で MCP サーバーを実行します
version · help	—	CLI のバージョン · 使用方法

結果は標準出力に、進行状況とエラーは標準エラー出力に送られるため、安全にパイプやリダイレクトを利用できます。--json は常に単一の JSON オブジェクトまたは配列を出力します。whispernotes help で使用方法の全容を表示できます。コマンドの使い方が誤っている場合は、正確な使用方法を示す行が返されます。wn は便利なエイリアスです。スクリプトやエージェントでは、常に利用できる whispernotes を呼び出してください。

プライバシーとセキュリティ

• 通信には、アクセス権が 0600 に設定された ~/Library/Application Support/WhisperNotes/api.sock の Unix ドメインソケットを使用します。接続できるのは、お使いの macOS ユーザーアカウントのみです。TCP ポートやネットワークインターフェイスは使用しないため、他のマシンからアクセスすることはできません。
• デフォルトではオフです。設定で有効にするまで、何も提供されません。
• Claude などの MCP クライアントは、各ツールの呼び出し前に承認を求めます。
• 文字起こしはデバイス上で実行されます（Neural Engine／MLX 上の Parakeet V3、Whisper、SenseVoice）。結果はローカルの履歴にのみ保存されます。

リンク

• ドキュメント：whispernotes.app/cli-mcp · エージェント向けの Markdown 原文：/cli-mcp.md
• ダウンロード：Mac 用 Whisper Notes（DMG）
• iPhone と Mac の App Store：App Store
• ウェブサイト：whispernotes.app · 変更履歴 · プライバシー
• サポート：[email protected]

ライセンス

このリポジトリの内容（ドキュメントおよびメタデータ）は MIT ライセンスの下で公開されています。Whisper Notes 自体（組み込みの MCP サーバーと CLI を含むアプリケーション）は商用ソフトウェアです。利用条件については whispernotes.app をご覧ください。