get_note - Tiro Docs

概要

get_note は特定のノートの詳細なメタデータを取得し、オプションで要約・トランスクリプト・生成ドキュメントを1 回の並列呼び出しで含めます。追加のコンテンツを要求するには include パラメータを使用します。要求されたリソースはすべて同時に取得されるため、1 つが失敗しても残りのレスポンスはブロックされません。これは、2026-05-06 に削除された list_note_summaries、get_note_summary、list_note_documents、get_note_document の各ツールを置き換えた、統合されたコンテンツ取得ツールです。 主なユースケース:

ノートの基本情報（参加者、日付、所要時間）だけが必要なときに、メタデータのみを取得する。
summary を含めて、AI が生成した要約の全文を取得する。
transcript を含めて、会話の全文（タイムスタンプ付きの段落を 1 つの文字列として結合したもの）を取得する。
documents を含めて、ノート上のすべての生成ドキュメント（ワンページャー、カスタムなど）を全文インラインで取得する。

主な特長:

Promise.allSettled を使った並列取得。1 つのリソースが失敗しても、他は返ります。
include はオプションの配列 enum: ["summary"]、["transcript"]、["documents"]、またはそれらの任意の組み合わせ。
documents オプションは、ノート上のすべてのドキュメントの全文を返します（5KB で打ち切られる search_notes とは異なります）。
include が空または省略された場合はメタデータのみを返します。

注記: get_note は仕様上ドキュメントの全文を返すため、ドキュメントごとに 5KB で打ち切られる search_notes より重くなります。コンテンツのプレビューには search_notes をご利用ください。

パラメータ

Parameter	Type	Required	Description
`noteGuid`	string	Yes	ノートの一意な識別子。通常は `list_notes` または `search_notes` から取得します。
`include`	array	Optional	コンテンツオプションの配列: `"summary"`、`"transcript"`、`"documents"`。いずれも任意で、追加的に指定できます。メタデータのみの場合は省略するか空配列を渡します。

noteGuid (required)

ノートの一意な識別子です。例:

{
  "noteGuid": "abc-123-def"
}

include (optional)

並列で取得するコンテンツタイプの配列です。有効なオプション:

"summary" — ノートで最初に利用可能な AI 生成要約（全文）を取得します。
"transcript" — 会話のトランスクリプト全文（段落を \n\n で結合）を取得します。
"documents" — ノート上のすべての生成ドキュメント（ワンページャー、カスタムなど）を全文で取得します。

例:

// Metadata only
{}

// With summary
{ "include": ["summary"] }

// With transcript and documents
{ "include": ["transcript", "documents"] }

// All three
{ "include": ["summary", "transcript", "documents"] }

レスポンス形式

成功レスポンス

{
  "noteGuid": "abc-123-def",
  "guid": "abc-123-def",
  "title": "Q2 OKR Planning",
  "webUrl": "https://platform.tiro.ooo/notes/abc-123-def",
  "participants": [
    { "name": "Alice Kim", "email": "alice@example.com" },
    { "name": "Bob Park", "email": null }
  ],
  "createdAt": "2026-04-15T10:00:00Z",
  "updatedAt": "2026-04-15T11:30:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "summary": {
    "content": "## Key Decisions\n- Q2 roadmap prioritizes...\n## Action Items\n- Alice: finalize spec by...",
    "format": "MARKDOWN",
    "summaryId": "summary-id-123"
  },
  "transcript": "[10:00:05] Alice: Let's start with Q2 planning.\n[10:00:18] Bob: Sure, here's what...",
  "documents": [
    {
      "documentId": 42,
      "templateId": 1,
      "templateTitle": "One Pager",
      "locale": "en",
      "sections": [
        {
          "content": "## OKR Goals\nGoal 1: ...",
          "format": "MARKDOWN"
        }
      ],
      "createdAt": "2026-04-15T11:30:00Z"
    }
  ]
}

フィールドの説明:

Field	Type	Description
`noteGuid` / `guid`	string	ノート識別子（後方互換性のため両方のフィールドが存在します）。
`title`	string	ノートのタイトル。
`webUrl`	string	Tiro Web アプリ内のノートへの直接リンク。
`createdAt`	string	ISO 8601 形式の作成タイムスタンプ。
`updatedAt`	string	ISO 8601 形式の最終更新タイムスタンプ。
`recordingDurationSeconds`	number	録音の長さ（秒）。
`sourceType`	string	`live-voice`、`recording`、`text`、`video`、`webpage`、`offline-mode`、`onboarding` のいずれか。
`participants[]`	array	参加者ごとの `{ name, email }`。いずれも `null` の場合があります。
`summary`（含めた場合）	object	要約が存在する場合は `{ content, format, summaryId }`、存在しない場合は `null`。
`summary.content`	string	要約テキスト（HTML 除去済み、Markdown 対応）。
`summary.format`	string	`MARKDOWN` または `PLAIN_TEXT`。
`summary.summaryId`	string	要約の識別子。
`transcript`（含めた場合）	string	`[HH:MM:SS]` を行頭に付したトランスクリプト全文を `\n\n` で結合したもの。トランスクリプトがない場合は `null`。
`documents`（含めた場合）	array	ドキュメントオブジェクトの配列、なければ `null`。`include: ["documents"]` を要求したがノートにドキュメントがない場合は空配列 `[]`。
`documents[].documentId`	number	安定したドキュメント識別子。
`documents[].templateId`	number	数値のテンプレート ID（識別には `templateTitle` ではなくこちらを使用します）。
`documents[].templateTitle`	string	表示用ラベル（ロケール依存、カスタムテンプレートではユーザーが編集可能）。
`documents[].locale`	string	ドキュメントのロケール（例: `"en"`、`"ko"`）。
`documents[].sections[]`	array	`{ content, format }` セクションの配列。
`documents[].sections[].content`	string	セクションのテキスト（HTML 除去済み）。
`documents[].sections[].format`	string	コンテンツの形式（`MARKDOWN`、`PLAIN_TEXT` など）。
`documents[].createdAt`	string	ISO 8601 形式のドキュメント作成タイムスタンプ。

要求したリソースが利用できない場合（例: 要約が存在しない）、フィールドは省略されるのではなく null に設定されます。これにより、呼び出し元は「リクエストに含めなかった」と「含めたが利用できなかった」を区別できます。

使用例

例 1: メタデータのみ

リクエスト:

{
  "noteGuid": "abc-123-def"
}

レスポンス:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice"
}

例 2: 要約のみ

リクエスト:

{
  "noteGuid": "abc-123-def",
  "include": ["summary"]
}

レスポンス:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "summary": {
    "content": "## Key Decisions\n- OKR prioritizes feature X...\n## Action Items\n- Alice: finalize spec",
    "format": "MARKDOWN",
    "summaryId": "summary-id-123"
  }
}

例 3: トランスクリプトとドキュメント

リクエスト:

{
  "noteGuid": "abc-123-def",
  "include": ["transcript", "documents"]
}

レスポンス:

{
  "noteGuid": "abc-123-def",
  "title": "Q2 Planning",
  "participants": [{ "name": "Alice Kim", "email": "alice@example.com" }],
  "createdAt": "2026-04-15T10:00:00Z",
  "recordingDurationSeconds": 3625,
  "sourceType": "live-voice",
  "transcript": "[10:00:05] Alice: Let's start with Q2 planning...\n[10:00:18] Bob: Sure...",
  "documents": [
    {
      "documentId": 42,
      "templateId": 1,
      "templateTitle": "One Pager",
      "locale": "en",
      "sections": [
        { "content": "## OKR Goals\n...", "format": "MARKDOWN" }
      ],
      "createdAt": "2026-04-15T11:30:00Z"
    }
  ]
}

例 4: すべてのコンテンツを 1 回の呼び出しで

リクエスト:

{
  "noteGuid": "abc-123-def",
  "include": ["summary", "transcript", "documents"]
}

メタデータ、要約、トランスクリプト全文、すべてのドキュメントを並列で返します。いずれか 1 つが失敗した場合（例: 要約が存在しない）、そのフィールドは null になりますが、他は引き続き返ります。

ベストプラクティス

Use include selectively

必要なコンテンツだけを要求してください。メタデータは ~50 トークン、要約を加えると ~200 トークン、トランスクリプトは 1 時間あたり ~3,000–5,000 トークン、ドキュメントはサイズによって変わります。まずメタデータから始め、概要をすばやく把握したい場合は get_note(include: ["summary"]) に、アクションアイテムや要点が必要な場合は get_note(include: ["documents"]) に切り替えてください。

Use search_notes for content preview

ノートの内容をすばやく確認するには、まず search_notes を使用してください。一致したノートを、5KB で打ち切られたドキュメントとともに返します。ドキュメントの全文が必要な場合にのみ get_note(include: ["documents"]) を使用してください。

Handle null gracefully

include: ["summary"] を設定しても要約が存在しない場合、summary は null になります。コードはこれを処理する必要があります。要求したからといって、フィールドが常に値を持つと想定しないでください。

Combining discovery and content

段階的開示パターン: list_notes → search_notes → get_note(include: [...])。ほとんどのワークフローはステップ 2 で止まります。全文が必要なときや、それ以前のツールでは十分でないときにのみステップ 3 を使用してください。

よくあるエラー

ノートが見つからない

解決方法: noteGuid が正しいことを確認してください。有効なノート識別子を見つけるには list_notes または search_notes を使用します。

スコープが不足

解決方法: お使いの API key に mcp:notes:read スコープがあることを確認してください。スコープの構成については Setup をご覧ください。

トークン使用量

Mode	Tokens
メタデータのみ	~50
メタデータ + 要約	~250
メタデータ + トランスクリプト	1 時間あたり ~3,000–5,000
メタデータ + ドキュメント	~1,000–5,000（ドキュメントのサイズによる）
3 つすべて	~4,000–10,000（変動あり）

統合による節約: 以前の list_note_summaries + get_note_summary の連鎖は、1 回の get_note(include: ["summary"]) 呼び出しに収まります。list_note_documents + get_note_document → get_note(include: ["documents"]) も同様です。

​概要

​パラメータ

​noteGuid (required)

​include (optional)

​レスポンス形式

​成功レスポンス

​使用例

​例 1: メタデータのみ

​例 2: 要約のみ

​例 3: トランスクリプトとドキュメント

​例 4: すべてのコンテンツを 1 回の呼び出しで

​ベストプラクティス

​よくあるエラー

​ノートが見つからない

​スコープが不足

​トークン使用量

​関連ツール

概要

パラメータ

noteGuid (required)

include (optional)

レスポンス形式

成功レスポンス

使用例

例 1: メタデータのみ

例 2: 要約のみ

例 3: トランスクリプトとドキュメント

例 4: すべてのコンテンツを 1 回の呼び出しで

ベストプラクティス

よくあるエラー

ノートが見つからない

スコープが不足

トークン使用量

関連ツール