rimo mcp は、rimo バイナリに同梱されたModel Context Protocolサーバーを起動します。

AIエージェントに組み込むと、エージェントはノートの一覧表示・トランスクリプトの取得・キーワード／意味による検索・自然言語での質問を、CLIを介してJSONを解析することなく、型付きツールとして直接呼び出せます。

1. 必要条件

rimo がインストールされ、$PATH 上にあること
rimo version で確認できます。未インストールの場合は、「Rimo CLI」のインストールを参照してください。
ログイン済みのアカウント
rimo auth login を実行してブラウザで認証してください。トークンは OS の認証情報ストアに保存されます。MCPサーバーはCLIと同じ認証情報を再利用するため、MCP専用のログインは不要です。

2. クライアント別のセットアップ

.mcp.json に rimo エントリを追加します。プロジェクトローカル（./.mcp.json、リポジトリと一緒にコミット）または、ユーザーグローバル（~/.claude/mcp.json）のどちらでも動作します。

{
  "mcpServers": {
    "rimo": {
      "type": "stdio",
      "command": "rimo",
      "args": ["mcp"]
    }
  }
}

Claude Codeを再起動すると、新しいサーバーが起動します。Rimoのツールがツールピッカーに表示されるので、自然言語で問いかけるだけで Claude Codeが適切なツールにルーティングします。

Codexは、Claude Codeと同じ .mcp.json のスキーマでMCPサーバーを取り込みます。上記のスニペットを追加してからCodexを再起動してください。

.mcp.json を自動検出しない Codex設定の場合は、起動オプションでファイルパスを明示的に指定してください。

Cursorの設定 → MCP → Add new MCP server で以下を入力します。

保存してCursorのMCPパネルをリロードすると、Rimoのツールが表示されます。

stdio JSON-RPCを扱える任意のMCPクライアントで動作します。

起動コマンドは以下のとおりです。

rimo mcp

クライアントは、stdoutからJSON-RPCを読み取り、stdinに書き込みます。ログ出力はstderrに流れるため、プロトコルストリームと衝突することはありません。

ツール名	役割
`note_list`	自分のノートを一覧表示 `page_size` / `page_token` でページネーション可能
`note_list_attended`	参加者として出席したノートの一覧
`note_get`	IDで1 件のノートを取得 `meta=true` でメタ情報のみ
`note_list_participants`	ノートの参加者一覧（トランスクリプトの `speaker_uuid` と結合可能）
`note_list_documents`	ノートに添付されたドキュメントの一覧
`note_get_document`	ノートからIDで1 件のドキュメントを取得
`note_search`	ノート全体に対するキーワード検索
`note_semantic_search`	概念／意味ベースの検索（ランク付けされたノートを返す。AI による回答なし）
`note_ask`	自然言語クエリ — AI による合成回答とソースノートを返します
`rimo_auth_status`	設定済みアカウントの一覧（`rimo auth status` と同じ形式）
`rimo_commands`	JSON Schema を含むツールカタログ全体 1 回の呼び出しで発見可能

rimo mcp を組み込んだあとは、エージェントが自然言語の入力から適切なツールを選択します。

問いかけ	エージェントが選ぶツール
「今週のRimoノートを見せて。」	`note_list`
「前回のスプリントで出席したRimoミーティングは?」	`note_list_attended`
「ノート `<id>` のトランスクリプトを取得して。」	`note_get`
「ミーティング `<id>` の参加者は誰?」	`note_list_participants`
「ノート `<id>` に添付されているドキュメントは?」	`note_list_documents`
「ノート `<id>` からドキュメント `<doc>` を取得して。」	`note_get_document`
「Rimoノートで『料金戦略』に言及しているものを探して。」	`note_search`
「オンボーディングに関するノート — その表現を使っていなくても。」	`note_semantic_search`
「Q3リリースについて何を決めた?」	`note_ask`
「現在ログインしている Rimo アカウントは?」	`rimo_auth_status`
「使えるRimoツールを全部教えて。」	`rimo_commands`

すべてのRimo APIツールは、各操作固有のパラメータに加えて、以下の引数を受け付けます。CLIのグローバルフラグと対応しています。

引数	型	効果
`account`	string	特定の設定済みアカウントを使用（`--account` と同じ）
`fields`	string	残すレスポンスフィールドのカンマ区切りホワイトリスト（`--fields` と同じ）
`excludes`	string	除外するレスポンスフィールドのカンマ区切りリスト（`--excludes` と同じ）
`dry_run`	boolean	副作用なしでシミュレーションする（`--dry-run` と同じ）