superwhisperのCLI:インストール、全コマンド、MCPサーバー
著者 Ryleigh Newman · 公開日
superwhisperには、Mac用のコマンドラインツールがあり、名前も同じsuperwhisperです。ローカルの音声入力の履歴を検索して書き出し、語彙と置き換えを編集し、起動中のアプリを操作します。操作は、開始、停止、モードの切り替え、ファイルの文字起こしです。MCP(Model Context Protocol)サーバーとしても動かせるので、AIアシスタントに音声入力の検索と読み取りをさせられます。
私はMac用の別の音声入力アプリ、YapToTextを作っているので、superwhisperについて私が書くことは、その点をふまえて読んでください。ここにあるsuperwhisperの事実はすべて、同社のドキュメントを2026年10月10日に読んだものです。読んだのは、CLI and MCP serverのページです。
無料でダウンロードできます。アカウント不要で、機能の制限もありません。AppleシリコンのMac、macOS 14以降に対応しています。 ソースコードはGitHubにあります。
ほかの言語で読む: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
インストールする
curl -fsSL https://superwhisper.com/install-cli.sh | bash実行されること: スクリプトは最新のリリースを/usr/local/binにインストールします。書き込めない場合は~/.local/binにインストールします。
そのあとシェルがsuperwhisperを見つけられない場合は、~/.local/binをPATHに追加してください。ドキュメントによると、バイナリとチェックサムはGitHubのsuperultrainc/superwhisper-cli-releaseリポジトリで公開されているので、実行する前にインストールのスクリプトを読めます。CLIはmacOS専用です。
履歴を読むコマンド
superwhisperのドキュメントのページCLI and MCP serverより、2026年10月10日に確認。これらはアプリと同じローカルのデータベースを読み、お使いの端末上で動きます。
| コマンド | することの内容 |
|---|---|
| search | すべての文字起こしを全文検索します。AND、OR、NOT、引用符で囲んだフレーズ、末尾のアスタリスクに対応しています |
| history | 最近の文字起こしを一覧にします。--mode、--since、--beforeで絞り込めます |
| read | 文字起こしをひとつ読みます。IDを指定しなければ最新のものです。--rawはAIの処理前のテキストを表示します |
| stats | 文字起こしの統計です |
| modes | 録音で使われたモードを、回数つきで一覧にします |
| export | 古い順にすべてを、jsonlまたはmarkdownで書き出します |
| vocab | 語彙の用語を一覧にし、追加し、削除します |
| snippets | 置き換えを一覧にし、設定し、削除します。Settings、VocabularyにあるFromとToのペアと同じです |
| doctor | バグ報告のための、データベースの診断情報です |
| completions | シェルの補完を生成します |
アプリを操作するコマンド
同じページより。これらは起動中のアプリにリクエストを送るので、superwhisperが開いている必要があります。
| コマンド | することの内容 |
|---|---|
| record | 録音の開始と停止を切り替えます |
| start | 録音を開始します。すでに録音中なら何もしません |
| stop | 録音を停止します。録音中でなければ何もしません |
| switch | 名前またはキーで、使用中のモードを切り替えます。引数がなければ、モードを一覧にします |
| settings | 設定のウィンドウを開きます |
| transcribe | 音声ファイルをアプリに送って文字起こしします。ファイルの文字起こしにはProが必要です |
start、stop、switchがあるので、シェルのコマンドを実行できるものなら何からでも、superwhisperをスクリプトで操作できます。 たとえば、ランチャー、キーボードのリマップツール、補助スイッチのインターフェースのボタンです。
例
superwhisper search "quarterly report"
superwhisper history --since 2026-09-01 --mode Mail
superwhisper read --raw
superwhisper export -f markdown > dictations.md
superwhisper vocab add "Superwhisper"
superwhisper switch Message
superwhisper transcribe ~/Downloads/note.m4a実行されること: どの行も、ドキュメントにある例そのものです。ほとんどのコマンドは--jsonも受け付け、スクリプトが読める形式で出力します。
MCPサーバー
superwhisper mcp実行されること: CLIがstdioでMCPを話し、検索、履歴、録音の読み取り、モード、統計、語彙、スニペットのツールを公開します。
ドキュメントにあるプライバシーの注意点がひとつあります。CLI自体は完全にお使いの端末上で動きますが、AIアシスタントをMCPで接続すると、そのアシスタントが問い合わせた文字起こしはアシスタントに送られ、アシスタント側のモデルとデータの設定で扱われます。そのほかのことは、superwhisperのプライバシーのページで説明しています。
YapToTextとコマンドライン
YapToTextには、コマンドラインのツールもMCPサーバーもありません。キーひとつで使う、メニューバーのアプリです。Historyページは、リスト全体をプレーンテキストまたはMarkdownで書き出せるので、Terminalを使わなくても書き出しはできます。
何も買わずにTerminalから文字起こしをしたいなら、YapToTextの土台のエンジンであるwhisper.cppがあります。コマンドはローカルのWhisperのガイドに、ファイルとフォルダ向けの別のアプリのツールはMacWhisperのCLIのページにあります。
無料でダウンロードできます。アカウント不要で、機能の制限もありません。AppleシリコンのMac、macOS 14以降に対応しています。 ソースコードはGitHubにあります。
まとめ
- インストール。 curlの1行だけで、macOS専用です。
- 読む。 search、history、read、stats、export。
- 操作する。 record、start、stop、switch、transcribe。アプリが開いている必要があります。
- MCP。 stdioでsuperwhisper mcpを実行します。
- プライバシー。 アシスタントがMCP経由で文字起こしを読むまでは、ローカルです。
superwhisperがコマンドを追加したり名前を変えたりした場合は、GitHubでissueを作成してください。このページを更新します。すべて読んでいます。
無料でダウンロードできます。アカウント不要で、機能の制限もありません。AppleシリコンのMac、macOS 14以降に対応しています。 ソースコードはGitHubにあります。
ガイド
そのほかのガイド(英語)
出典
- https://superwhisper.com/docs/get-started/cli (確認日 2026年10月10日)
- https://superwhisper.com/docs/get-started/history (確認日 2026年10月10日)
- https://github.com/ryleighnewman/YapToText (確認日 2026年10月10日)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (確認日 2026年10月10日)
よくある質問
superwhisperにCLIはありますか
はい、macOSで使えます。superwhisperコマンドは、履歴の検索と書き出し、語彙の編集、起動中のアプリの操作ができます。
superwhisperのCLIをインストールするには
ドキュメントにあるインストールのスクリプトを、curlで実行します。/usr/local/binにインストールされ、書き込めない場合は~/.local/binになります。
Terminalからsuperwhisperの録音を始められますか
はい。superwhisper start、stop、recordで録音を操作できます。アプリが開いている必要があります。
superwhisperにMCPサーバーはありますか
はい。superwhisper mcpを実行すると、CLIがstdioでMCPサーバーとして動き、検索、履歴、語彙、スニペットのツールを使えます。
superwhisperのCLIはWindowsで使えますか
いいえ。ドキュメントによると、CLIはmacOS専用です。