> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# get_note

> 要約・トランスクリプト・ドキュメントを 1 回の呼び出しでオプション取得しながらノートを取得します

## 概要

`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` が空または省略された場合はメタデータのみを返します。

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

## パラメータ

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

### noteGuid (required)

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

**例:**

```json theme={"system"}
{
  "noteGuid": "abc-123-def"
}
```

### include (optional)

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

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

**例:**

```json theme={"system"}
// Metadata only
{}

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

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

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

## レスポンス形式

### 成功レスポンス

```json theme={"system"}
{
  "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 形式のドキュメント作成タイムスタンプ。                                                         |

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

## 使用例

### 例 1: メタデータのみ

**リクエスト:**

```json theme={"system"}
{
  "noteGuid": "abc-123-def"
}
```

**レスポンス:**

```json theme={"system"}
{
  "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: 要約のみ

**リクエスト:**

```json theme={"system"}
{
  "noteGuid": "abc-123-def",
  "include": ["summary"]
}
```

**レスポンス:**

```json theme={"system"}
{
  "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: トランスクリプトとドキュメント

**リクエスト:**

```json theme={"system"}
{
  "noteGuid": "abc-123-def",
  "include": ["transcript", "documents"]
}
```

**レスポンス:**

```json theme={"system"}
{
  "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 回の呼び出しで

**リクエスト:**

```json theme={"system"}
{
  "noteGuid": "abc-123-def",
  "include": ["summary", "transcript", "documents"]
}
```

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

## ベストプラクティス

<AccordionGroup>
  <Accordion title="Use include selectively">
    必要なコンテンツだけを要求してください。メタデータは \~50 トークン、要約を加えると \~200 トークン、トランスクリプトは 1 時間あたり \~3,000–5,000 トークン、ドキュメントはサイズによって変わります。

    まずメタデータから始め、概要をすばやく把握したい場合は `get_note(include: ["summary"])` に、アクションアイテムや要点が必要な場合は `get_note(include: ["documents"])` に切り替えてください。
  </Accordion>

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

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

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

## よくあるエラー

### ノートが見つからない

<Error>
  ```json theme={"system"}
  {
    "error": "Note not found",
    "code": "NOT_FOUND",
    "statusCode": 404
  }
  ```
</Error>

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

### スコープが不足

<Error>
  ```json theme={"system"}
  {
    "error": "Insufficient scope: mcp:notes:read required",
    "code": "FORBIDDEN",
    "statusCode": 403
  }
  ```
</Error>

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

## トークン使用量

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

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

## 関連ツール

* **[`search_notes`](./search-notes)** — キーワードでノートを見つけ、なおかつそのドキュメントを読む必要があるとき。最大 10 件の一致ノートを、ドキュメントごとに 5KB で打ち切られたコンテンツとともに返します。
* **[`list_notes`](./list-notes)** — どのノートが存在するかを知るだけのとき。最も軽量な階層で、メタデータのみです。
* **[`get_note_transcript`](./get-transcript)** — タイムスタンプ付きの生のトランスクリプト用（フォールバック。並列取得のためには、このツールで `include: ["transcript"]` を使用してください）。
* **[`list_document_templates`](./overview)** — ドキュメントを要求する前に、利用可能なドキュメントテンプレートの種類を確認します。