superwhisperのCLI:インストール、全コマンド、MCPサーバー

superwhisperには、Mac用のコマンドラインツールがあり、名前も同じsuperwhisperです。ローカルの音声入力の履歴を検索して書き出し、語彙と置き換えを編集し、起動中のアプリを操作します。操作は、開始、停止、モードの切り替え、ファイルの文字起こしです。MCP(Model Context Protocol)サーバーとしても動かせるので、AIアシスタントに音声入力の検索と読み取りをさせられます。

私はMac用の別の音声入力アプリ、YapToTextを作っているので、superwhisperについて私が書くことは、その点をふまえて読んでください。ここにあるsuperwhisperの事実はすべて、同社のドキュメントを2026年10月10日に読んだものです。読んだのは、CLI and MCP serverのページです。

Mac App StoreでYapToTextをダウンロード無料でダウンロードできます。アカウント不要で、機能の制限もありません。AppleシリコンのMac、macOS 14以降に対応しています。 ソースコードはGitHubにあります。

インストールする

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のページにあります。

Mac App StoreでYapToTextをダウンロード無料でダウンロードできます。アカウント不要で、機能の制限もありません。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を作成してください。このページを更新します。すべて読んでいます。

Mac App StoreでYapToTextをダウンロード無料でダウンロードできます。アカウント不要で、機能の制限もありません。AppleシリコンのMac、macOS 14以降に対応しています。 ソースコードはGitHubにあります。

このページを書いた人。 Ryleigh Newmanはソフトウェアを開発しています。手でキーボードを打つことが難しいため、このサイトで紹介しているアプリ、YapToTextで毎日音声入力をしています。このページは英語から翻訳したものです。アプリの画面とサイトのほかのページは英語です。 プロジェクトについて(英語)。

ガイド

そのほかのガイド(英語)

出典

よくある質問

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専用です。