meetrecord

meetrecord

会議はすでに、Recordist アプリ内のご自身のマシンに保存されています。meetrecord は会議にアクセスするための小さなブリッジです。同じマシン上のループバック経由でアプリのローカル API と通信し、会議の一覧表示と検索、文字起こしの閲覧、アクションアイテムの確認、メモの再生成、録音の開始または停止を行う 9 つのツールを提供します。

meetrecord 自体からマシンの外へ送信されるものはありません。すべてのリクエストは Recordist アプリに送られ、処理方法はアプリが決定します。アプリが実行されていない場合、各ツールは推測せず、「Recordist app is not running」と明確に通知します。ヘルスプローブで事前に確認し、成功したプローブの結果は 5 秒間再利用するため、短時間に連続して呼び出してもアプリに過剰な負荷がかかりません。

9 つのツール：

• list_meetings — 最近の会議を一覧表示します。任意で全文検索クエリ、from／to による日付範囲、limit／offset によるページネーションを指定できます。
• get_meeting — メモ、アクションアイテム、マーカーを含む 1 件の会議を取得します。
• get_transcript — 会議の文字起こしを json、md、srt、vtt、txt 形式で取得します（既定値は md）。それ以外の値を指定すると、利用可能な形式の一覧とともにエラーになります。
• search_meetings — 文字起こしとメモを対象に全文検索します。クエリは空にできません。
• get_action_items — アクションアイテムを取得します。特定の会議、または未完了のアイテムのみに絞り込むこともできます。
• regenerate_notes — Recordist で設定されているプロバイダーを使って、会議の AI メモを再生成します。任意で特定のメモテンプレートを指定できます。
• start_recording — 録音を開始します。任意でソースアプリ、タイトル、参加者を指定できます。Recordist の Settings → Integrations で「Allow agents to start recordings」が有効になっている場合のみ、この要求が受け付けられます。
• stop_recording — 現在の録音を停止します。
• add_marker — 現在の時点にブックマークを追加します。任意でラベルを指定できます。

アプリからエラーが返された場合、アプリがメッセージを提供していれば、そのメッセージがそのまま返されます。提供されていない場合、meetrecord は検出した HTTP ステータスを報告します。

設定

export RECORDIST_API_URL="http://127.0.0.1:47321"   # default; the app on this machine
export RECORDIST_API_TOKEN="..."                    # optional; see below
export RECORDIST_DATA_DIR="..."                     # optional; where api_token lives

認証にはベアラートークンを使用します。RECORDIST_API_TOKEN が設定されている場合はその値が優先されます。設定されていない場合、meetrecord は RECORDIST_DATA_DIR 内の api_token ファイルを読み込みます。既定の場所は ~/.local/share/app.recordist.desktop/api_token です。トークンなしで送信されるリクエストは、ヘルスプローブのみです。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドです。

npx @reneturcios/meetrecord list_meetings '{"q":"budget","limit":5}'
npx @reneturcios/meetrecord get_transcript '{"meeting_id":"m123","format":"srt"}'
npx @reneturcios/meetrecord start_recording '{"title":"Weekly sync"}'
npx @reneturcios/meetrecord --version

出力は、アプリが返したレスポンス本文です。終了コード： 成功時は 0、ツールエラー（アプリが実行されていない場合など）を含む実行時エラー時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/meetrecord mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "meetrecord": {
      "command": "npx",
      "args": ["-y", "@reneturcios/meetrecord", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/meetrecord
docker run --rm ghcr.io/cloudcorprecords/meetrecord list_meetings '{}'

コンテナは独立したマシンであることに注意してください。この方法で実行する場合は、コンテナから Recordist アプリにアクセスできる場所を RECORDIST_API_URL に指定してください。

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake file reader + fake clock, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios