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

# MCPツール

> Caret MCPサーバーで利用可能なツール

Caret MCPサーバーは、ワークスペースデータにアクセスするための6つの読み取り専用ツールを提供しています。すべてのツールは [OAuth 2.0またはAPIキー](/api-reference/mcp/authentication) による認証が必要です。

## caret\_list\_notes

ワークスペースのミーティングノートをオプションのフィルター付きで一覧取得します。基本情報を含むページネーション付きのノート一覧を返します。文字起こしやサマリーを含む詳細情報は `caret_get_note` を使用してください。

**必要な権限:** `notes`

### パラメータ

<ParamField query="limit" type="number" default="20">
  返すノート数（1–100）
</ParamField>

<ParamField query="offset" type="number" default="0">
  ページネーションオフセット
</ParamField>

<ParamField query="sortBy" type="string" default="createdAt">
  ソート基準。オプション: `createdAt`, `updatedAt`, `title`
</ParamField>

<ParamField query="sortOrder" type="string" default="desc">
  ソート順。オプション: `asc`, `desc`
</ParamField>

<ParamField query="status" type="string">
  ノートのステータスフィルター。オプション: `idle`, `recording`,
  `transcript-processing`, `recorded-not-summarized`, `summarizing`, `completed`
</ParamField>

<ParamField query="search" type="string">
  タイトル検索クエリ
</ParamField>

<ParamField query="fromDate" type="string">
  指定日以降に作成されたノートをフィルター（ISO 8601）
</ParamField>

<ParamField query="toDate" type="string">
  指定日以前に作成されたノートをフィルター（ISO 8601）
</ParamField>

<ParamField query="folderIds" type="string">
  カンマ区切りのフォルダIDフィルター
</ParamField>

<ParamField query="participantEmail" type="string">
  参加者のメールアドレスフィルター
</ParamField>

### レスポンス

<ResponseField name="notes" type="NoteListItem[]">
  <Expandable title="NoteListItem">
    <ResponseField name="id" type="string">
      ノートID
    </ResponseField>

    <ResponseField name="title" type="string">
      ノートタイトル
    </ResponseField>

    <ResponseField name="kind" type="string">
      ノートの種類: `online`、`in-person`、または `podcast`
    </ResponseField>

    <ResponseField name="status" type="string">
      現在のステータス
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="visibility" type="string">
      `private`、`workspace`、または `shared`
    </ResponseField>

    <ResponseField name="tags" type="object[]">
      ノートに割り当てられたフォルダ/タグ
    </ResponseField>

    <ResponseField name="participants" type="object[]">
      名前、メール、会社情報を含むミーティング参加者
    </ResponseField>

    <ResponseField name="totalDurationSec" type="number">
      録音時間（秒）
    </ResponseField>

    <ResponseField name="userWrittenNote" type="string">
      ユーザーのプライベートメモ
    </ResponseField>

    <ResponseField name="calendarEvent" type="object | null">
      関連するカレンダーイベント
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination">
    <ResponseField name="limit" type="number">
      ページあたりの件数
    </ResponseField>

    <ResponseField name="offset" type="number">
      現在のオフセット
    </ResponseField>

    <ResponseField name="hasMore" type="boolean">
      追加結果の有無
    </ResponseField>

    <ResponseField name="nextOffset" type="number | null">
      次のページのオフセット。最終ページの場合はnull
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_get\_note

特定のノートの文字起こし、サマリー、参加者情報を含む詳細情報を取得します。

**必要な権限:** `notes`

### パラメータ

<ParamField query="id" type="string" required>
  ノートID
</ParamField>

<ParamField query="folderIds" type="string">
  ノートが属している必要があるフォルダID（カンマ区切り）
</ParamField>

### レスポンス

<ResponseField name="note" type="Note">
  <Expandable title="Note">
    <ResponseField name="id" type="string">
      ノートID
    </ResponseField>

    <ResponseField name="title" type="string">
      ノートタイトル
    </ResponseField>

    <ResponseField name="kind" type="string">
      ノートの種類
    </ResponseField>

    <ResponseField name="status" type="string">
      現在のステータス
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="visibility" type="string">
      `private`、`workspace`、または `shared`
    </ResponseField>

    <ResponseField name="tags" type="object[]">
      フォルダ/タグ
    </ResponseField>

    <ResponseField name="participants" type="object[]">
      参加者の詳細
    </ResponseField>

    <ResponseField name="totalDurationSec" type="number">
      録音時間（秒）
    </ResponseField>

    <ResponseField name="userWrittenNote" type="string">
      ユーザーのプライベートメモ
    </ResponseField>

    <ResponseField name="enhancedNote" type="string">
      AI強化ノートの内容
    </ResponseField>

    <ResponseField name="summary" type="string">
      AI生成サマリー
    </ResponseField>

    <ResponseField name="transcripts" type="Transcript[]">
      <Expandable title="Transcript">
        <ResponseField name="speaker" type="string">
          話者名
        </ResponseField>

        <ResponseField name="text" type="string">
          発話テキスト
        </ResponseField>

        <ResponseField name="startTimestamp" type="string">
          開始時刻（HH:MM:SS）
        </ResponseField>

        <ResponseField name="endTimestamp" type="string">
          終了時刻（HH:MM:SS）
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="calendarEvent" type="object | null">
      出席者、時刻、ミーティングリンクを含むカレンダーイベント
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_search\_notes

タイトルでノートを検索します。基本情報を含む一致するノートを返します。

**必要な権限:** `notes`

### パラメータ

<ParamField query="query" type="string" required>
  検索クエリ
</ParamField>

<ParamField query="limit" type="number" default="10">
  返す結果数（1–50）
</ParamField>

<ParamField query="folderIds" type="string">
  フィルタするフォルダID（カンマ区切り）
</ParamField>

### レスポンス

<ResponseField name="notes" type="NoteListItem[]">
  一致するノートの配列（`caret_list_notes` と同じ構造）
</ResponseField>

<ResponseField name="query" type="string">
  使用された検索クエリ
</ResponseField>

<ResponseField name="count" type="number">
  返された結果数
</ResponseField>

***

## caret\_search\_knowledge

自然言語を使用してミーティングノートとワークスペースのナレッジを検索します。セマンティック検索を使用して、ミーティングサマリー、Q\&A、ナレッジベース記事から関連コンテンツを見つけます。

**必要な権限:** `notes`

### パラメータ

<ParamField query="query" type="string" required>
  自然言語検索クエリ（例：「顧客は価格について何と言っていた？」）
</ParamField>

<ParamField query="sourceType" type="string" default="all">
  検索するソースの種類。オプション:
  `all`、`meeting`（ミーティングノートのみ）、`knowledge`（ナレッジベースのみ）
</ParamField>

<ParamField query="maxResults" type="number" default="5">
  返す最大結果数（1–20）
</ParamField>

### レスポンス

<ResponseField name="results" type="SearchResult[]">
  <Expandable title="SearchResult">
    <ResponseField name="content" type="string">
      一致したコンテンツの抜粋
    </ResponseField>

    <ResponseField name="score" type="number">
      関連性スコア
    </ResponseField>

    <ResponseField name="sourceTitle" type="string">
      ソースドキュメントのタイトル
    </ResponseField>

    <ResponseField name="sourceType" type="string">
      ソースの種類（meeting、knowledgeなど）
    </ResponseField>

    <ResponseField name="url" type="string">
      ソースのURL（ある場合）
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="query" type="string">
  使用された検索クエリ
</ResponseField>

<ResponseField name="sourceType" type="string">
  適用されたソースタイプフィルター
</ResponseField>

<ResponseField name="totalResults" type="number">
  返された結果数
</ResponseField>

***

## caret\_get\_workspace

名前、設定、許可メールドメインなど、現在のワークスペースの詳細情報を取得します。

**必要な権限:** なし

### パラメータ

パラメータは不要です。

### レスポンス

<ResponseField name="workspace" type="Workspace">
  <Expandable title="Workspace">
    <ResponseField name="id" type="string">
      ワークスペースID
    </ResponseField>

    <ResponseField name="name" type="string">
      ワークスペース名
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="settings" type="object">
      ワークスペース設定
    </ResponseField>

    <ResponseField name="allowedEmailDomains" type="string[]">
      ワークスペースの許可メールドメイン
    </ResponseField>

    <ResponseField name="iconUrl" type="string | null">
      ワークスペースアイコンURL
    </ResponseField>
  </Expandable>
</ResponseField>

***

## caret\_list\_members

ワークスペースメンバーをオプションの検索付きで一覧取得します。名前、メール、ロール、割り当てフォルダなどのメンバー情報を返します。

**必要な権限:** `users`

### パラメータ

<ParamField query="limit" type="number" default="20">
  返すメンバー数（1–100）
</ParamField>

<ParamField query="offset" type="number" default="0">
  ページネーションオフセット
</ParamField>

<ParamField query="search" type="string">
  名前またはメールで検索
</ParamField>

### レスポンス

<ResponseField name="members" type="Member[]">
  <Expandable title="Member">
    <ResponseField name="id" type="string">
      ユーザーID
    </ResponseField>

    <ResponseField name="name" type="string">
      フルネーム
    </ResponseField>

    <ResponseField name="email" type="string">
      メールアドレス
    </ResponseField>

    <ResponseField name="profileUrl" type="string">
      プロフィール画像URL
    </ResponseField>

    <ResponseField name="role" type="string">
      ワークスペースロール
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601タイムスタンプ
    </ResponseField>

    <ResponseField name="folders" type="object[]">
      IDと名前を含む割り当てフォルダ
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination">
    <ResponseField name="limit" type="number">
      ページあたりの件数
    </ResponseField>

    <ResponseField name="offset" type="number">
      現在のオフセット
    </ResponseField>

    <ResponseField name="hasMore" type="boolean">
      追加結果の有無
    </ResponseField>

    <ResponseField name="nextOffset" type="number | null">
      次のページのオフセット
    </ResponseField>
  </Expandable>
</ResponseField>
