Nyask Docs
JA EN
アプリを開く
MCP API Catalog

MCP API カタログ

Nyask が MCP (Model Context Protocol) エンドポイント経由で提供する全 88 種類のツール一覧。

88 tools read33 write55 destructive17

接続と認証

これらの Tool は ChatGPT / Claude Desktop / Cursor などの MCP クライアントから呼び出せます。接続手順と認証・scope は専用ページにまとめています。

作業アイテム 22

タスク / Items 12

items_bulk_patch write destructive

複数タスク(最大 25 件)に同じフィールド変更を一括適用する。単一タスクは items_patch を使う。実行には確認が必要。

パラメータ 13 · 入力スキーマ
引数必須
item_refs array yes
title string no
detail string no
due_date string no
due_time string no
start_date string no
priority string no
labels array no
archived_at string no
area_id string no
kind string no
estimate string no
sprint_id string no
json
{
  "type": "object",
  "properties": {
    "item_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-25 item refs like [\"#42\",\"WORK#43\"] (project prefix optional; bare \"#42\" resolves owner-wide)."
    },
    "title": {
      "type": "string"
    },
    "detail": {
      "type": "string",
      "description": "Replaces detail of every target item."
    },
    "due_date": {
      "type": "string",
      "format": "date"
    },
    "due_time": {
      "type": "string",
      "description": "Time-of-day for the due date in HH:MM (JST, 24h). null to clear (all-day). Applies to every target item."
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "priority": {
      "type": "string",
      "enum": [
        "urgent",
        "high",
        "normal",
        "low"
      ]
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "archived_at": {
      "type": "string",
      "description": "ISO 8601 datetime to archive every item. Pass null to unarchive. Omit to leave unchanged."
    },
    "area_id": {
      "type": "string",
      "description": "Area id to assign to every target item (must belong to each item's own project). Pass null to clear the area on every item. Omit to leave unchanged. For path-based single-item assignment prefer project_areas_assign_item."
    },
    "kind": {
      "type": "string",
      "description": "Work-item kind key to set on every target item (lowercase / digits / - _, e.g. \"story\", \"bug\"). Pass null to clear the kind on every item. Omit to leave unchanged. Not validated against each project's custom kinds — built-in kinds always work."
    },
    "estimate": {
      "type": "string",
      "description": "Estimate value to set on every target item (must match each project's estimate unit, e.g. numeric for sp/hours). Pass null to clear the estimate on every item. Omit to leave unchanged."
    },
    "sprint_id": {
      "type": "string",
      "description": "Sprint id to assign every target item to (must belong to each item's own project). Pass null to remove every item from its (non-closed) sprint. Omit to leave unchanged."
    }
  },
  "required": [
    "item_refs"
  ]
}
items_bulk_patch_preview read

items_bulk_patch の事前プレビュー(dry-run)。各タスクの現在値・適用後の値・変更されるフィールドを返す。書き込みはしない。

パラメータ 12 · 入力スキーマ
引数必須
item_refs array yes
title string no
detail string no
due_date string no
due_time string no
start_date string no
priority string no
labels array no
archived_at string no
kind string no
estimate string no
sprint_id string no
json
{
  "type": "object",
  "properties": {
    "item_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-25 item refs like [\"#42\",\"WORK#43\"] (project prefix optional; bare \"#42\" resolves owner-wide)."
    },
    "title": {
      "type": "string"
    },
    "detail": {
      "type": "string",
      "description": "Replaces detail of every target item."
    },
    "due_date": {
      "type": "string",
      "format": "date"
    },
    "due_time": {
      "type": "string",
      "description": "HH:MM in JST (24h). null clears time (back to all-day)."
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "priority": {
      "type": "string"
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "archived_at": {
      "type": "string",
      "description": "ISO 8601 datetime to archive. null to unarchive. Omit to leave unchanged."
    },
    "kind": {
      "type": "string",
      "description": "Work-item kind key (lowercase). null clears. Omit to leave unchanged."
    },
    "estimate": {
      "type": "string",
      "description": "Estimate value (must match project unit). null clears. Omit to leave unchanged."
    },
    "sprint_id": {
      "type": "string",
      "description": "Sprint id to assign. null removes from sprint. Omit to leave unchanged."
    }
  },
  "required": [
    "item_refs"
  ]
}
items_complete write

タスクを完了状態にする。「完了の既定」に設定されたワークフロー状態へ遷移する。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
reason string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "reason": {
      "type": "string",
      "description": "Optional reason for completion."
    }
  },
  "required": [
    "item_ref"
  ]
}
items_context_get read

タスク本体に加え、添付・ディスカッション・保留中リマインダー・リレーションを 1 回でまとめて取得する。読み取り専用。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
include array no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "attachments",
          "discussions",
          "reminders",
          "relations"
        ]
      },
      "description": "Sections to include. Default: all of [\"attachments\",\"discussions\",\"reminders\",\"relations\"]. Pass a subset to reduce payload."
    }
  },
  "required": [
    "item_ref"
  ]
}
items_create write

新しいタスクを作成する。プロジェクト未指定なら Inbox に作成。kind・親・バージョン・スプリント・エリア・期日などを指定できる。

パラメータ 13 · 入力スキーマ
引数必須
project_key string yes
title string yes
detail string no
due_date string no
due_time string no
start_date string no
priority string no
labels array no
kind string no
parent string no
version string no
sprint string no
area_path string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Required. Existing project key to create the task in. Pass \"INBOX\" for the Inbox project (no implicit default)."
    },
    "title": {
      "type": "string",
      "description": "Task title (1-200 chars)."
    },
    "detail": {
      "type": "string",
      "description": "Optional task detail/description (Markdown, up to 32000 chars/call). For longer content, create first then append in chunks via items_patch detail_append."
    },
    "due_date": {
      "type": "string",
      "description": "Due date in YYYY-MM-DD (JST).",
      "format": "date"
    },
    "due_time": {
      "type": "string",
      "description": "Optional time-of-day for the due date in HH:MM (JST, 24h). Requires due_date. Omit to keep the task all-day."
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD.",
      "format": "date"
    },
    "priority": {
      "type": "string",
      "enum": [
        "urgent",
        "high",
        "normal",
        "low"
      ],
      "description": "Optional priority."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional labels."
    },
    "kind": {
      "type": "string",
      "enum": [
        "epic",
        "story",
        "task",
        "bug",
        "chore"
      ],
      "description": "Optional work-item kind. Built-in kinds: epic / story / task / bug / chore — pick one of these directly (no lookup needed). Projects with board profiles may define custom kinds (lowercase / digits / - _); discover them via item_kinds_list and they are also accepted here."
    },
    "parent": {
      "type": "string",
      "description": "Optional parent item reference (e.g. \"WORK#10\") to link this item under as a child."
    },
    "version": {
      "type": "string",
      "description": "Optional version name to assign this item to at creation time (e.g. \"v2.0\"). Must exist in the project. If parent is given and version is omitted, the parent's version is inherited."
    },
    "sprint": {
      "type": "string",
      "description": "Optional sprint name or path to assign this item to at creation time (e.g. \"Sprint 3\" or \"Q3/Sprint 1\"). Must exist and not be closed. If parent is given and sprint is omitted, the parent's active/planned sprint is inherited."
    },
    "area_path": {
      "type": "string",
      "description": "Optional area path within the project to assign this item to (e.g. \"API/Auth\"). Must exist and not be archived. Pass null to skip inheritance when a parent is set. If parent is given and area_path is omitted, the parent's area is inherited."
    }
  },
  "required": [
    "project_key",
    "title"
  ]
}
items_get read

ref を指定してアイテム(タスク/ノート/予定/テンプレート)の詳細本文を取得する。長い本文はチャンク分割取得にも対応。

パラメータ 3 · 入力スキーマ
引数必須
item_ref string yes
detail_offset number no
detail_max_chars number no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "detail_offset": {
      "type": "number",
      "description": "Optional. Start character offset into the detail body for windowed reads of a large detail. Default 0 (start of body). Combine with detail_max_chars to page through a long body using the detail_next_offset returned in the response."
    },
    "detail_max_chars": {
      "type": "number",
      "description": "Optional. Max number of characters of detail to return starting at detail_offset. Omit to return the full remaining body (default = full detail, backward compatible). When the slice is partial, the response sets detail_truncated=true and detail_next_offset for the next chunk."
    }
  },
  "required": [
    "item_ref"
  ]
}
items_grep read

アイテム全体を対象にした完全一致/正規表現検索。網羅的・決定的で「どこにも無い」ことの証明にも使える(query の精密版)。

パラメータ 11 · 入力スキーマ
引数必須
pattern string yes
regex boolean no
ignore_case boolean no
fields array no
custom_field_keys array no
filters string no
context_chars number no
count_only boolean no
limit_items number no
max_snippets_per_item number no
cursor string no
json
{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Search text. Literal substring by default; a JS RegExp when regex=true."
    },
    "regex": {
      "type": "boolean",
      "description": "Interpret pattern as a regular expression (JS RegExp)."
    },
    "ignore_case": {
      "type": "boolean",
      "description": "Case-insensitive match."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "title",
          "detail",
          "labels",
          "comments.body",
          "comments.author",
          "custom.value",
          "custom.key"
        ]
      },
      "description": "Fields to search. Omit for content default (title/detail/labels/comments.body/custom.value). comments.author and custom.key are opt-in (not indexed, force a scan)."
    },
    "custom_field_keys": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Restrict custom field search to these field_keys."
    },
    "filters": {
      "type": "string",
      "description": "Filter-only DSL (e.g. \"type:note priority:high area:Platform/API agile_kind:bug cf:severity\"). Free text here is ignored — use `pattern` for the search text."
    },
    "context_chars": {
      "type": "number",
      "description": "Snippet context characters around a match (default 80)."
    },
    "count_only": {
      "type": "boolean",
      "description": "Return per-item match counts without snippets/locators."
    },
    "limit_items": {
      "type": "number",
      "description": "Max items per page (default 50)."
    },
    "max_snippets_per_item": {
      "type": "number",
      "description": "Max snippets emitted per item (default 3)."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from a prior response."
    }
  },
  "required": [
    "pattern"
  ]
}
items_move_state write

タスクを指定のワークフロー状態へ移す。状態 id は workflow_states_list から取得する。完了は items_complete を使う。

パラメータ 3 · 入力スキーマ
引数必須
item_ref string yes
status_definition_id string yes
reason string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "status_definition_id": {
      "type": "string",
      "description": "Target workflow state id (= workflow_states_list `id`). Must belong to this item's project workflow."
    },
    "reason": {
      "type": "string",
      "description": "Optional reason for the state change."
    }
  },
  "required": [
    "item_ref",
    "status_definition_id"
  ]
}
items_patch write

既存タスクの属性(タイトル/本文/期日/優先度/ラベル/親など)を更新する。本文は全置換・追記・部分編集を選べる。ワークフロー状態は変更しない。

パラメータ 12 · 入力スキーマ
引数必須
item_ref string yes
title string no
detail string no
detail_append string no
detail_edits array no
due_date string no
due_time string no
start_date string no
priority string no
labels array no
archived_at string no
parent string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "title": {
      "type": "string"
    },
    "detail": {
      "type": "string",
      "description": "Replaces the entire detail/description (up to 32000 chars/call). Use detail_append to add text instead."
    },
    "detail_append": {
      "type": "string",
      "description": "Text to append to the existing detail (詳細欄), up to 32000 chars/call. Use this when the user says \"追記\" or \"詳細追加\", and to add long content in chunks (total detail is capped at 100000 chars)."
    },
    "detail_edits": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "find": {
            "type": "string",
            "description": "Exact substring to find in the current detail."
          },
          "replace": {
            "type": "string",
            "description": "Replacement text."
          },
          "occurrence": {
            "type": "string",
            "enum": [
              "first",
              "all"
            ],
            "description": "Which occurrences to replace. Default: first."
          }
        },
        "required": [
          "find",
          "replace"
        ]
      },
      "description": "Partial edit of detail by find-and-replace. Use when the user wants to change specific parts of the detail without rewriting the whole text. Each edit is applied in order; if any find string is not found, the entire operation is aborted (all-or-nothing). Mutually exclusive with detail and detail_append."
    },
    "due_date": {
      "type": "string",
      "format": "date",
      "description": "Due date in YYYY-MM-DD (JST). null to clear."
    },
    "due_time": {
      "type": "string",
      "description": "Time-of-day for the due date in HH:MM (JST, 24h). null to clear time (back to all-day). Note: changing due_date alone resets due_time to null unless you also pass due_time."
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "priority": {
      "type": "string",
      "enum": [
        "urgent",
        "high",
        "normal",
        "low"
      ]
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "archived_at": {
      "type": "string",
      "description": "ISO 8601 datetime to archive the task. Pass null to unarchive. Omit to leave unchanged."
    },
    "parent": {
      "type": "string",
      "description": "New parent item reference (e.g. \"WORK#10\") to set/re-parent this item under. Replaces any existing parent (single-parent). Pass null to detach (top-level). Omit to leave unchanged. A descendant cannot be set as parent (cycle is rejected). Does NOT inherit the parent's version/sprint/area."
    }
  },
  "required": [
    "item_ref"
  ]
}
items_set_custom_fields write

タスクのカスタムフィールド値を設定/クリアする。field_key は project_custom_fields_list で確認する。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
custom_fields object yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item ref, e.g. \"WORK#42\" or \"#42\"."
    },
    "custom_fields": {
      "type": "object",
      "description": "Map of field_key → value (text in v1.0). Empty string or null clears the field. field_keys come from project_custom_fields_list."
    }
  },
  "required": [
    "item_ref",
    "custom_fields"
  ]
}
items_summarize write

確定済みディスカッションからアイテムの自動要約(detail_summary)を再生成する(非同期)。本文は変更しない。オーナーが自動要約を有効化している場合のみ。

パラメータ 1 · 入力スキーマ
引数必須
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    }
  },
  "required": [
    "item_ref"
  ]
}
tasks_list read

タスクをフィルタ付きで検索・一覧する。ref・タイトル・期日・優先度・状態・本文などを返す。DSL クエリにも対応。

パラメータ 15 · 入力スキーマ
引数必須
project_key string no
status string no
due_before string no
due_after string no
title_contains string no
q string no
sort string no
order string no
limit number no
include_custom_fields boolean no
include_relations boolean no
include_agile boolean no
include_area boolean no
include_attachments boolean no
include_custom_numbers boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Filter by project key (e.g. \"WORK\"). Omit for all projects."
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "closed"
      ],
      "description": "Filter by open/closed status. Omit for all."
    },
    "due_before": {
      "type": "string",
      "format": "date",
      "description": "Return tasks due on or before this date (YYYY-MM-DD)."
    },
    "due_after": {
      "type": "string",
      "format": "date",
      "description": "Return tasks due on or after this date (YYYY-MM-DD)."
    },
    "title_contains": {
      "type": "string",
      "description": "Filter tasks whose title contains this string (case-insensitive)."
    },
    "q": {
      "type": "string",
      "description": "DSL query string (e.g. \"is:open priority:p1 due:>=today\"). Merged with explicit args."
    },
    "sort": {
      "type": "string",
      "enum": [
        "due",
        "created",
        "updated",
        "priority"
      ],
      "description": "Order field. \"due\" (default) = by due date; \"created\" = by registration date; \"updated\" = by last-modified; \"priority\" = by priority. For 「一番古いタスク」 use \"created\" with order \"asc\"."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Direction for `sort` (applies to created/updated). \"asc\" = oldest first, \"desc\" = newest first. Default \"desc\". Ignored for due/priority."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)."
    },
    "include_custom_fields": {
      "type": "boolean",
      "description": "Opt-in: when true, each returned task includes its project-defined custom field values (`custom_fields`: array of { field_key, label, field_type, value }). Default false (omitted) to keep the response lightweight. Use this when the user asks about a custom field (e.g. a per-project \"priority_rank\" / \"ADR\" field) so you can answer without a follow-up items_get per task."
    },
    "include_relations": {
      "type": "boolean",
      "description": "Opt-in: include the parent link (parent_ref / parent_title / parent_kind) so you can see an item's hierarchy without a follow-up call. Default false (omitted)."
    },
    "include_agile": {
      "type": "boolean",
      "description": "Opt-in: include agile placement (sprint_id / sprint_name / version_id / version_name / resolved_field_policy). Note estimate / agile_kind are already always included. Default false (omitted)."
    },
    "include_area": {
      "type": "boolean",
      "description": "Opt-in: include the assigned area (area_id / area_path, e.g. \"Product/Search\"). Default false (omitted)."
    },
    "include_attachments": {
      "type": "boolean",
      "description": "Opt-in: include attachment_count (number of non-deleted attachments). Default false (omitted)."
    },
    "include_custom_numbers": {
      "type": "boolean",
      "description": "Opt-in: include custom series refs (custom_numbers: array of { series_key, display_ref, number }, e.g. \"INV-0012\"). Default false (omitted)."
    }
  }
}

ノート 2

notes_create write

行動を伴わない情報・アイデア・参考資料を記録するノート(type=note)を作成する。追跡対象のタスクは items_create を使う。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
title string yes
body string no
labels array no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Required. Existing project key to create the note in. Pass \"INBOX\" for the Inbox project (no implicit default)."
    },
    "title": {
      "type": "string",
      "description": "Short heading shown in lists (1-200 chars)."
    },
    "body": {
      "type": "string",
      "description": "Note body / content (long-form Markdown supported). Strongly recommended; the note is mostly empty without it."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional labels."
    }
  },
  "required": [
    "project_key",
    "title"
  ]
}
notes_list read

ノートをフィルタ付きで検索・一覧する。本文(detail)も返す。

パラメータ 10 · 入力スキーマ
引数必須
project_key string no
title_contains string no
q string no
limit number no
include_custom_fields boolean no
include_relations boolean no
include_agile boolean no
include_area boolean no
include_attachments boolean no
include_custom_numbers boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Filter by project key (e.g. \"WORK\"). Omit for all projects."
    },
    "title_contains": {
      "type": "string",
      "description": "Filter notes whose title contains this string (case-insensitive)."
    },
    "q": {
      "type": "string",
      "description": "DSL query string. Merged with explicit args."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)."
    },
    "include_custom_fields": {
      "type": "boolean",
      "description": "Opt-in: when true, each returned note includes its project-defined custom field values (`custom_fields`: array of { field_key, label, field_type, value }). Default false (omitted) to keep the response lightweight."
    },
    "include_relations": {
      "type": "boolean",
      "description": "Opt-in: include the parent link (parent_ref / parent_title / parent_kind) so you can see an item's hierarchy without a follow-up call. Default false (omitted)."
    },
    "include_agile": {
      "type": "boolean",
      "description": "Opt-in: include agile placement (sprint_id / sprint_name / version_id / version_name / resolved_field_policy). Note estimate / agile_kind are already always included. Default false (omitted)."
    },
    "include_area": {
      "type": "boolean",
      "description": "Opt-in: include the assigned area (area_id / area_path, e.g. \"Product/Search\"). Default false (omitted)."
    },
    "include_attachments": {
      "type": "boolean",
      "description": "Opt-in: include attachment_count (number of non-deleted attachments). Default false (omitted)."
    },
    "include_custom_numbers": {
      "type": "boolean",
      "description": "Opt-in: include custom series refs (custom_numbers: array of { series_key, display_ref, number }, e.g. \"INV-0012\"). Default false (omitted)."
    }
  }
}

カレンダー予定 1

events_list read

カレンダー予定をフィルタ付きで検索・一覧する。日付・開始時刻・本文などを返す。カレンダー機能が無効だとエラー。

パラメータ 13 · 入力スキーマ
引数必須
project_key string no
status string no
due_before string no
due_after string no
title_contains string no
q string no
limit number no
include_custom_fields boolean no
include_relations boolean no
include_agile boolean no
include_area boolean no
include_attachments boolean no
include_custom_numbers boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Filter by project key (e.g. \"WORK\"). Omit for all projects."
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "closed"
      ],
      "description": "Filter by open/closed status. Omit for all."
    },
    "due_before": {
      "type": "string",
      "format": "date",
      "description": "Return events on or before this date (YYYY-MM-DD)."
    },
    "due_after": {
      "type": "string",
      "format": "date",
      "description": "Return events on or after this date (YYYY-MM-DD)."
    },
    "title_contains": {
      "type": "string",
      "description": "Filter events whose title contains this string (case-insensitive)."
    },
    "q": {
      "type": "string",
      "description": "DSL query string. Merged with explicit args."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-20, default 10)."
    },
    "include_custom_fields": {
      "type": "boolean",
      "description": "Opt-in: when true, each returned event includes its project-defined custom field values (`custom_fields`: array of { field_key, label, field_type, value }). Default false (omitted) to keep the response lightweight."
    },
    "include_relations": {
      "type": "boolean",
      "description": "Opt-in: include the parent link (parent_ref / parent_title / parent_kind) so you can see an item's hierarchy without a follow-up call. Default false (omitted)."
    },
    "include_agile": {
      "type": "boolean",
      "description": "Opt-in: include agile placement (sprint_id / sprint_name / version_id / version_name / resolved_field_policy). Note estimate / agile_kind are already always included. Default false (omitted)."
    },
    "include_area": {
      "type": "boolean",
      "description": "Opt-in: include the assigned area (area_id / area_path, e.g. \"Product/Search\"). Default false (omitted)."
    },
    "include_attachments": {
      "type": "boolean",
      "description": "Opt-in: include attachment_count (number of non-deleted attachments). Default false (omitted)."
    },
    "include_custom_numbers": {
      "type": "boolean",
      "description": "Opt-in: include custom series refs (custom_numbers: array of { series_key, display_ref, number }, e.g. \"INV-0012\"). Default false (omitted)."
    }
  }
}

添付ファイル 3

attachments_download read

添付ファイルのバイナリを取得する。小さい画像は base64 で inline、それ以外は短命の署名付き URL を返す。読み取り専用。

パラメータ 1 · 入力スキーマ
引数必須
attachment_id string yes
json
{
  "type": "object",
  "properties": {
    "attachment_id": {
      "type": "string",
      "description": "UUID of the attachment."
    }
  },
  "required": [
    "attachment_id"
  ]
}
attachments_get read

attachment_id を指定して添付 1 件のメタデータを取得する。読み取り専用。

パラメータ 1 · 入力スキーマ
引数必須
attachment_id string yes
json
{
  "type": "object",
  "properties": {
    "attachment_id": {
      "type": "string",
      "description": "UUID of the attachment."
    }
  },
  "required": [
    "attachment_id"
  ]
}
attachments_list read

特定のアイテム/ディスカッション/チャットメッセージに紐づく添付ファイル一覧を取得する(メタデータのみ)。読み取り専用。

パラメータ 3 · 入力スキーマ
引数必須
parent_kind string yes
parent_ref string no
parent_id string no
json
{
  "type": "object",
  "properties": {
    "parent_kind": {
      "type": "string",
      "enum": [
        "item",
        "discussion",
        "ai_chat_message"
      ],
      "description": "Parent resource kind."
    },
    "parent_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed. Required when parent_kind=\"item\". For discussion / ai_chat_message use parent_id instead."
    },
    "parent_id": {
      "type": "string",
      "description": "UUID parent id (required when parent_kind != \"item\")."
    }
  },
  "required": [
    "parent_kind"
  ]
}

カスタム採番 4

custom_numbers_assign write

アイテムを名前付きシリーズに採番して紐づける。自動採番/番号指定、番号なしの link-only に対応。凍結シリーズは拒否される。

パラメータ 4 · 入力スキーマ
引数必須
item_ref string yes
series_key string yes
number number no
link_only boolean no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item ref (\"WORK#42\" / \"#42\") or display_ref (\"INV-0012\")."
    },
    "series_key": {
      "type": "string",
      "description": "Series key from custom_sequences_list."
    },
    "number": {
      "type": "number",
      "description": "Optional explicit number. Omit for auto-numbering. Do not pass with link_only."
    },
    "link_only": {
      "type": "boolean",
      "description": "Attach without a number (membership only). number must be omitted."
    }
  },
  "required": [
    "item_ref",
    "series_key"
  ]
}
custom_numbers_unassign write destructive

アイテムから指定シリーズのカスタム番号を外す。欠番は再利用されない。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
series_key string yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item ref or display_ref."
    },
    "series_key": {
      "type": "string",
      "description": "Series key whose number to remove."
    }
  },
  "required": [
    "item_ref",
    "series_key"
  ]
}
custom_sequences_list read

オーナーが定義したカスタム採番シリーズの一覧。次の採番値プレビューや凍結レベルも返す。

入力スキーマ
json
{
  "type": "object",
  "properties": {}
}
item_custom_numbers_list read

特定アイテムが属する全シリーズのカスタム番号/リンクを一覧する。

パラメータ 1 · 入力スキーマ
引数必須
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item ref. Main ref (\"WORK#42\" / \"#42\") or custom display_ref (\"INV-0012\")."
    }
  },
  "required": [
    "item_ref"
  ]
}

関連付け・対話 14

リレーション 5

relations_bulk_create write destructive

複数タスク(最大 25 件)を 1 つの相手タスクへ一括でリンクする。単一は relations_create。実行には確認が必要。

パラメータ 4 · 入力スキーマ
引数必須
member_refs array yes
counterpart_ref string yes
relation_type string yes
member_role string no
json
{
  "type": "object",
  "properties": {
    "member_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-25 item refs like [\"#42\",\"WORK#43\"] (project prefix optional). Each is linked to counterpart_ref."
    },
    "counterpart_ref": {
      "type": "string",
      "description": "The single item every member is linked to, e.g. \"#50\" (prefix optional). For parent hierarchy this is the parent."
    },
    "relation_type": {
      "type": "string",
      "enum": [
        "parent",
        "child",
        "reference",
        "duplicate",
        "generated_from",
        "enriches",
        "previous_instance"
      ],
      "description": "Kind of relation applied to every pair."
    },
    "member_role": {
      "type": "string",
      "enum": [
        "source",
        "target"
      ],
      "description": "Whether each member_refs item is the source (default) or target of the relation. Keep \"source\" for attaching children to a parent with relation_type=\"parent\"."
    }
  },
  "required": [
    "member_refs",
    "counterpart_ref",
    "relation_type"
  ]
}
relations_create write

既存タスク 2 件の間にリレーション(親子・参照・重複など)を作成する。

パラメータ 3 · 入力スキーマ
引数必須
source_item_ref string yes
target_item_ref string yes
relation_type string yes
json
{
  "type": "object",
  "properties": {
    "source_item_ref": {
      "type": "string",
      "description": "Source item reference, e.g. \"#42\" (prefix optional) or \"WORK#42\"."
    },
    "target_item_ref": {
      "type": "string",
      "description": "Target item reference, e.g. \"#3\" (prefix optional) or \"INBOX#3\"."
    },
    "relation_type": {
      "type": "string",
      "enum": [
        "parent",
        "child",
        "reference",
        "duplicate",
        "generated_from",
        "enriches",
        "previous_instance"
      ],
      "description": "Kind of relation."
    }
  },
  "required": [
    "source_item_ref",
    "target_item_ref",
    "relation_type"
  ]
}
relations_delete write destructive

relation_id を指定してリレーションを削除する。id は relations_list で確認。実行には確認が必要。

パラメータ 1 · 入力スキーマ
引数必須
relation_id string yes
json
{
  "type": "object",
  "properties": {
    "relation_id": {
      "type": "string",
      "description": "Relation UUID (from relations_list)."
    }
  },
  "required": [
    "relation_id"
  ]
}
relations_list read

特定アイテムに紐づくリレーション一覧(source/target 両方)。削除前の id 確認や既存リンク確認に使う。

パラメータ 1 · 入力スキーマ
引数必須
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    }
  },
  "required": [
    "item_ref"
  ]
}
relations_reassign write destructive

複数アイテム(最大 25 件)のリレーションを from から to へ一括で付け替える。実行には確認が必要。

パラメータ 5 · 入力スキーマ
引数必須
member_refs array yes
relation_type string yes
from_ref string no
to_ref string no
member_role string no
json
{
  "type": "object",
  "properties": {
    "member_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 1-25 item refs being re-pointed (e.g. the children)."
    },
    "relation_type": {
      "type": "string",
      "enum": [
        "parent",
        "child",
        "reference",
        "duplicate",
        "generated_from",
        "enriches",
        "previous_instance"
      ],
      "description": "Kind of relation being reassigned."
    },
    "from_ref": {
      "type": "string",
      "description": "Current counterpart to detach from (e.g. the old parent). Omit to only attach."
    },
    "to_ref": {
      "type": "string",
      "description": "New counterpart to attach to (e.g. the new parent). Omit to only detach."
    },
    "member_role": {
      "type": "string",
      "enum": [
        "source",
        "target"
      ],
      "description": "Whether each member is the source (default) or target of the relation. Keep \"source\" for relation_type=\"parent\"."
    }
  },
  "required": [
    "member_refs",
    "relation_type"
  ]
}

ディスカッション 4

discussions_create write

既存タスクに決定・事実・進捗メモのディスカッションを投稿する。

パラメータ 3 · 入力スキーマ
引数必須
item_ref string yes
body string yes
kind string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "body": {
      "type": "string",
      "description": "Discussion body (Markdown, required; long-form supported)."
    },
    "kind": {
      "type": "string",
      "enum": [
        "decision",
        "fact",
        "progress"
      ],
      "description": "Optional kind tag."
    }
  },
  "required": [
    "item_ref",
    "body"
  ]
}
discussions_delete write destructive

ディスカッションを削除する。投稿者本人かプロジェクトオーナーのみ。実行には確認が必要。

パラメータ 1 · 入力スキーマ
引数必須
discussion_id string yes
json
{
  "type": "object",
  "properties": {
    "discussion_id": {
      "type": "string",
      "description": "Discussion id from discussions_list."
    }
  },
  "required": [
    "discussion_id"
  ]
}
discussions_list read

特定アイテムに紐づくディスカッション(決定/事実/進捗)一覧を取得する。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
limit number no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-30, default 10)."
    }
  },
  "required": [
    "item_ref"
  ]
}
discussions_patch write

既存ディスカッションの本文を更新する(投稿者本人のみ)。

パラメータ 2 · 入力スキーマ
引数必須
discussion_id string yes
body string yes
json
{
  "type": "object",
  "properties": {
    "discussion_id": {
      "type": "string",
      "description": "Discussion id from discussions_list."
    },
    "body": {
      "type": "string",
      "description": "New body (Markdown; long-form supported)."
    }
  },
  "required": [
    "discussion_id",
    "body"
  ]
}

リマインダー 5

reminders_create write

既存タスクにリマインダーを作成する。期日からの相対(分)か絶対時刻のどちらか一方を指定する。

パラメータ 3 · 入力スキーマ
引数必須
item_ref string yes
lead_time_minutes number no
remind_at string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Target item. Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "lead_time_minutes": {
      "type": "number",
      "description": "Minutes before due_date. Item must have due_date set."
    },
    "remind_at": {
      "type": "string",
      "description": "Absolute ISO 8601 timestamp."
    }
  },
  "required": [
    "item_ref"
  ]
}
reminders_delete write destructive

reminder_id を指定してリマインダーを削除する。実行には確認が必要。

パラメータ 1 · 入力スキーマ
引数必須
reminder_id string yes
json
{
  "type": "object",
  "properties": {
    "reminder_id": {
      "type": "string"
    }
  },
  "required": [
    "reminder_id"
  ]
}
reminders_list read

特定アイテムの保留中リマインダー一覧。patch/delete/snooze 前の id 確認に使う。

パラメータ 1 · 入力スキーマ
引数必須
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    }
  },
  "required": [
    "item_ref"
  ]
}
reminders_patch write

reminder_id を指定してリマインダー(相対分/絶対時刻/状態)を更新する。

パラメータ 4 · 入力スキーマ
引数必須
reminder_id string yes
lead_time_minutes number no
remind_at string no
status string no
json
{
  "type": "object",
  "properties": {
    "reminder_id": {
      "type": "string"
    },
    "lead_time_minutes": {
      "type": "number",
      "description": "Pass null to switch to absolute remind_at."
    },
    "remind_at": {
      "type": "string",
      "description": "Absolute ISO 8601 timestamp."
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "sent",
        "dismissed"
      ]
    }
  },
  "required": [
    "reminder_id"
  ]
}
reminders_snooze write

リマインダーを指定分だけスヌーズ(先送り)する。

パラメータ 2 · 入力スキーマ
引数必須
reminder_id string yes
snooze_minutes number yes
json
{
  "type": "object",
  "properties": {
    "reminder_id": {
      "type": "string"
    },
    "snooze_minutes": {
      "type": "number",
      "description": "Minutes to push remind_at into the future."
    }
  },
  "required": [
    "reminder_id",
    "snooze_minutes"
  ]
}

アジャイル運営 20

スプリント 10

sprints_add_item write

アイテムをスプリントに割り当てる。アイテムはスプリントと同じプロジェクトに属する必要がある。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path."
    },
    "item_ref": {
      "type": "string",
      "description": "Item reference (e.g. \"WORK#42\" or \"#42\")."
    }
  },
  "required": [
    "project_key",
    "sprint",
    "item_ref"
  ]
}
sprints_close write destructive

スプリントをクローズ(完了)しレビューを記録する。未完了アイテムの扱い(次スプリント/バックログ/分割/破棄)を指定する。velocity が確定する不可逆操作。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
dispositions array no
next_sprint string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path."
    },
    "dispositions": {
      "type": "array",
      "description": "Per unfinished-item handling. Omit for none (all unfinished items dropped).",
      "items": {
        "type": "object",
        "properties": {
          "item_ref": {
            "type": "string",
            "description": "Item reference (e.g. \"WORK#42\")."
          },
          "disposition": {
            "type": "string",
            "enum": [
              "next_sprint",
              "backlog",
              "split",
              "drop"
            ],
            "description": "How to handle this item on close."
          }
        },
        "required": [
          "item_ref",
          "disposition"
        ]
      }
    },
    "next_sprint": {
      "type": "string",
      "description": "Carry-over target sprint name / path. Required if any disposition is \"next_sprint\"."
    }
  },
  "required": [
    "project_key",
    "sprint"
  ]
}
sprints_create write

プロジェクトにスプリント(イテレーション)を作成する。Sprint 管理の有効化が必要。親スプリント配下にネスト可(最大深さ 3)。

パラメータ 8 · 入力スキーマ
引数必須
project_key string yes
name string yes
parent string no
goal string no
start_date string no
end_date string no
capacity number no
status string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "name": {
      "type": "string",
      "description": "Sprint name (max 120 chars)."
    },
    "parent": {
      "type": "string",
      "description": "Optional parent sprint name or path (e.g. \"Q3\" or \"Q3/Sprint 1\"). Omit / null for a root sprint."
    },
    "goal": {
      "type": "string",
      "description": "Optional sprint goal."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Optional start date (YYYY-MM-DD)."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Optional end date (YYYY-MM-DD)."
    },
    "capacity": {
      "type": "number",
      "description": "Optional numeric capacity target."
    },
    "status": {
      "type": "string",
      "enum": [
        "planning",
        "active",
        "closed"
      ],
      "description": "Lifecycle status. Defaults to \"planning\". \"active\" starts the sprint."
    }
  },
  "required": [
    "project_key",
    "name"
  ]
}
sprints_delete write destructive

スプリントを削除する(不可逆)。割り当ては解除されるがアイテムは残る。子スプリントがあると削除不可。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path."
    }
  },
  "required": [
    "project_key",
    "sprint"
  ]
}
sprints_handoff write destructive

アクティブなスプリントをクローズしつつ次のスプリントを起動する原子的なハンドオフ。Review/Retro の重なり期に使う。不可逆。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
next_sprint string yes
dispositions array no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Currently active sprint name or path (handed off / closed)."
    },
    "next_sprint": {
      "type": "string",
      "description": "Next sprint name / path to activate. Must be a planning, leaf (no children) sprint."
    },
    "dispositions": {
      "type": "array",
      "description": "Per unfinished-item handling. Omit for none (all unfinished items dropped).",
      "items": {
        "type": "object",
        "properties": {
          "item_ref": {
            "type": "string",
            "description": "Item reference (e.g. \"WORK#42\")."
          },
          "disposition": {
            "type": "string",
            "enum": [
              "next_sprint",
              "backlog",
              "split",
              "drop"
            ],
            "description": "How to handle this item on handoff (\"next_sprint\" carries it to next_sprint)."
          }
        },
        "required": [
          "item_ref",
          "disposition"
        ]
      }
    }
  },
  "required": [
    "project_key",
    "sprint",
    "next_sprint"
  ]
}
sprints_list read

プロジェクトのスプリント状況(計画/アクティブ/クローズ、ゴール、capacity、件数、残見積もりなど)を読み取る。リスク判断に使う。

パラメータ 1 · 入力スキーマ
引数必須
project_key string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Optional. Project key (e.g. \"WORK\") to scope to that project's Sprints. Omit to get the active Sprint across all projects."
    }
  }
}
sprints_note_get read

スプリントの固定ノート枠(計画メモ/レビュー/ふりかえり/Nyall サマリー)を読む。短い goal とは別枠。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path (e.g. \"Sprint 1\" or \"Q3/Sprint 1\")."
    }
  },
  "required": [
    "project_key",
    "sprint"
  ]
}
sprints_note_set write

スプリントの固定ノート枠(計画メモ/レビュー/ふりかえり/Nyall サマリー)を設定する(枠ごと置換)。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
slot string yes
body string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path (e.g. \"Sprint 1\" or \"Q3/Sprint 1\")."
    },
    "slot": {
      "type": "string",
      "enum": [
        "planning",
        "review",
        "retro",
        "nyall_summary"
      ],
      "description": "Which note slot: \"planning\" (計画メモ), \"review\" (レビュー), \"retro\" (ふりかえり), \"nyall_summary\" (Nyall サマリー)."
    },
    "body": {
      "type": "string",
      "description": "Markdown body. REPLACES the slot. Empty string clears (deletes) the slot."
    }
  },
  "required": [
    "project_key",
    "sprint",
    "slot",
    "body"
  ]
}
sprints_remove_item write

アイテムをスプリントから外す(割り当て解除のみ・アイテムは残す)。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path."
    },
    "item_ref": {
      "type": "string",
      "description": "Item reference (e.g. \"WORK#42\" or \"#42\")."
    }
  },
  "required": [
    "project_key",
    "sprint",
    "item_ref"
  ]
}
sprints_update write

スプリントを更新する(指定フィールドのみ変更)。クローズは sprints_close を使う。

パラメータ 9 · 入力スキーマ
引数必須
project_key string yes
sprint string yes
name string no
parent string no
goal string no
start_date string no
end_date string no
capacity number no
status string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint": {
      "type": "string",
      "description": "Target sprint name or path (e.g. \"Sprint 1\" or \"Q3/Sprint 1\")."
    },
    "name": {
      "type": "string",
      "description": "New name (rename)."
    },
    "parent": {
      "type": "string",
      "description": "New parent sprint name / path (move). null = make root. Omit = keep."
    },
    "goal": {
      "type": "string",
      "description": "Sprint goal. null clears."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Start date (YYYY-MM-DD). null clears."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "End date (YYYY-MM-DD). null clears."
    },
    "capacity": {
      "type": "number",
      "description": "Numeric capacity target. null clears."
    },
    "status": {
      "type": "string",
      "enum": [
        "planning",
        "active",
        "closed"
      ],
      "description": "Lifecycle status."
    }
  },
  "required": [
    "project_key",
    "sprint"
  ]
}

バージョン 5

versions_add_item write

アイテムをバージョンに割り当てる(1 アイテム=0..1 バージョン・既存割り当ては置換)。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
version string yes
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "version": {
      "type": "string",
      "description": "Target version name."
    },
    "item_ref": {
      "type": "string",
      "description": "Item reference (e.g. \"WORK#42\" or \"#42\")."
    }
  },
  "required": [
    "project_key",
    "version",
    "item_ref"
  ]
}
versions_create write

プロジェクトにバージョン(リリース/ロードマップのマイルストーン)を作成する。Version/Roadmap 管理の有効化が必要。

パラメータ 5 · 入力スキーマ
引数必須
project_key string yes
name string yes
description string no
target_date string no
status string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "name": {
      "type": "string",
      "description": "Version name (max 120 chars)."
    },
    "description": {
      "type": "string",
      "description": "Optional description."
    },
    "target_date": {
      "type": "string",
      "format": "date",
      "description": "Optional target date (YYYY-MM-DD)."
    },
    "status": {
      "type": "string",
      "enum": [
        "planning",
        "released",
        "archived"
      ],
      "description": "Lifecycle status. Defaults to \"planning\"."
    }
  },
  "required": [
    "project_key",
    "name"
  ]
}
versions_delete write destructive

バージョンを削除する(不可逆)。割り当ては解除されるがアイテムは残る。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
version string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "version": {
      "type": "string",
      "description": "Target version name."
    }
  },
  "required": [
    "project_key",
    "version"
  ]
}
versions_remove_item write

アイテムをバージョンから外す(割り当て解除のみ・アイテムは残す)。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
version string yes
item_ref string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "version": {
      "type": "string",
      "description": "Target version name."
    },
    "item_ref": {
      "type": "string",
      "description": "Item reference (e.g. \"WORK#42\" or \"#42\")."
    }
  },
  "required": [
    "project_key",
    "version",
    "item_ref"
  ]
}
versions_update write

バージョンを更新する(指定フィールドのみ)。status を released にすると released_at を記録する。

パラメータ 6 · 入力スキーマ
引数必須
project_key string yes
version string yes
name string no
description string no
target_date string no
status string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "version": {
      "type": "string",
      "description": "Target version name."
    },
    "name": {
      "type": "string",
      "description": "New name (rename)."
    },
    "description": {
      "type": "string",
      "description": "Description. null clears."
    },
    "target_date": {
      "type": "string",
      "format": "date",
      "description": "Target date (YYYY-MM-DD). null clears."
    },
    "status": {
      "type": "string",
      "enum": [
        "planning",
        "released",
        "archived"
      ],
      "description": "Lifecycle status."
    }
  },
  "required": [
    "project_key",
    "version"
  ]
}

見積り / 振り返り (AI 支援) 5

agile_estimate_suggest read

完了済みアイテムの実績を参照し、未見積もりバックログの見積もり案を提示する。書き込みはしない(ユーザーが確認・適用)。agile.ai と見積もり有効が必要。

パラメータ 1 · 入力スキーマ
引数必須
project_key string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\") to estimate unestimated items for."
    }
  },
  "required": [
    "project_key"
  ]
}
agile_improvement_suggest read

持ち越し率・velocity 傾向・リスク信号からプロセス改善案を提示する。提案のみで実行はしない。agile.ai とスプリント管理が必要。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
sprint_id string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "sprint_id": {
      "type": "string",
      "description": "Optional. Focus sprint for risk/aging signals. Defaults to the active sprint."
    }
  },
  "required": [
    "project_key"
  ]
}
agile_meta_patch write

アイテムの見積もりと/または work-item kind を設定/クリアする。見積もり有効が必要。

パラメータ 3 · 入力スキーマ
引数必須
item_ref string yes
estimate string no
kind string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference (e.g. \"WORK#42\" or \"#42\")."
    },
    "estimate": {
      "type": "string",
      "description": "Estimate value (must match project unit). null clears. Omit to keep."
    },
    "kind": {
      "type": "string",
      "description": "Work-item kind key (lowercase / digits / - _). null clears. Omit to keep."
    }
  },
  "required": [
    "item_ref"
  ]
}
agile_retro_draft write destructive

スプリントのふりかえりを AI が起草し nyall_summary 枠に保存する(後でユーザーが編集)。既存は overwrite=true で上書き。agile.ai とスプリント管理が必要。

パラメータ 2 · 入力スキーマ
引数必須
sprint_id string yes
overwrite boolean no
json
{
  "type": "object",
  "properties": {
    "sprint_id": {
      "type": "string",
      "description": "Target sprint id."
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace an existing nyall_summary draft. Default false (conflict if one exists)."
    }
  },
  "required": [
    "sprint_id"
  ]
}
agile_sprint_forecast read

velocity 履歴・バーンダウン・リスク信号からスプリントが期限内に終わるか予測する。完了予測日・確度・残ポイントなどを返す。読み取り専用。

パラメータ 1 · 入力スキーマ
引数必須
sprint_id string yes
json
{
  "type": "object",
  "properties": {
    "sprint_id": {
      "type": "string",
      "description": "Target sprint id."
    }
  },
  "required": [
    "sprint_id"
  ]
}

プロジェクト設定 25

ワークフロー状態 5

workflow_states_create write

ユーザー所有ワークフローに状態を追加する。system_status は open/closed。完了既定や初期状態などを設定できる。

パラメータ 8 · 入力スキーマ
引数必須
workflow_id string yes
name string yes
description string no
system_status string yes
category string no
status_attribute string no
color_hex string no
is_default boolean no
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "name": {
      "type": "string",
      "description": "Display name (1-80 chars)."
    },
    "description": {
      "type": "string",
      "description": "Optional hint on what this state means / when to use it (max 500 chars). Helps decide when to move an item into this state."
    },
    "system_status": {
      "type": "string",
      "enum": [
        "open",
        "closed",
        "closed_done",
        "closed_wontfix",
        "closed_duplicate"
      ],
      "description": "Dual-axis model: open=in-progress, closed=terminal. Legacy values closed_done/closed_duplicate/closed_wontfix are auto-decomposed."
    },
    "category": {
      "type": "string",
      "enum": [
        "todo",
        "in_progress",
        "review",
        "done"
      ],
      "description": "Optional progress category. open states allow todo/in_progress/review; closed states are always done. Omit to auto-derive from system_status (open→todo, closed→done). Backs the is:wip filter and board lanes."
    },
    "status_attribute": {
      "type": "string",
      "description": "Optional attribute label (open: pending, closed: done/duplicate/wontfix). Defaults to done for closed when omitted."
    },
    "color_hex": {
      "type": "string",
      "description": "Optional #RRGGBB color. Omit or null for unset."
    },
    "is_default": {
      "type": "boolean",
      "description": "Mark as initial state (workflow can have at most 1)."
    }
  },
  "required": [
    "workflow_id",
    "name",
    "system_status"
  ]
}
workflow_states_delete write destructive

ワークフロー状態をアーカイブする。参照中アイテムがあると拒否。関連する遷移も削除される。実行には確認が必要。

パラメータ 2 · 入力スキーマ
引数必須
workflow_id string yes
state_id string yes
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "state_id": {
      "type": "string",
      "description": "State id to archive."
    }
  },
  "required": [
    "workflow_id",
    "state_id"
  ]
}
workflow_states_list read

アイテムで使えるワークフロー状態(ステータス)一覧。project_key 指定でそのプロジェクト、未指定で全ワークフロー。状態 id は items_move_state 等に渡す。

パラメータ 1 · 入力スキーマ
引数必須
project_key string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Optional. Project key to scope to that project's workflow states."
    }
  }
}
workflow_states_reorder write

ワークフロー状態の表示順を一括変更する。state_ids は全アクティブ状態を過不足なく含める。

パラメータ 2 · 入力スキーマ
引数必須
workflow_id string yes
state_ids array yes
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "state_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "All active state ids in the new desired order."
    }
  },
  "required": [
    "workflow_id",
    "state_ids"
  ]
}
workflow_states_update write

ワークフロー状態を更新する(名称/説明/system_status/色/初期状態の切替)。

パラメータ 9 · 入力スキーマ
引数必須
workflow_id string yes
state_id string yes
name string no
description string no
system_status string no
category string no
status_attribute string no
color_hex string no
is_default boolean no
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "state_id": {
      "type": "string",
      "description": "State id from workflow_states_list."
    },
    "name": {
      "type": "string",
      "description": "New display name (1-80 chars)."
    },
    "description": {
      "type": "string",
      "description": "New \"what this state means\" hint (max 500 chars). Empty string clears it."
    },
    "system_status": {
      "type": "string",
      "enum": [
        "open",
        "closed",
        "closed_done",
        "closed_wontfix",
        "closed_duplicate"
      ],
      "description": "New semantic role (dual-axis model, legacy 4-values accepted)."
    },
    "category": {
      "type": "string",
      "enum": [
        "todo",
        "in_progress",
        "review",
        "done"
      ],
      "description": "New progress category. open states allow todo/in_progress/review; closed is always done. Changing system_status auto-corrects the category (→done for closed, →todo for open) when omitted."
    },
    "status_attribute": {
      "type": "string",
      "description": "New attribute label (open: pending / closed: done/duplicate/wontfix)."
    },
    "color_hex": {
      "type": "string",
      "description": "New #RRGGBB color. Pass null to clear."
    },
    "is_default": {
      "type": "boolean",
      "description": "true=mark as initial state, false=unset."
    }
  },
  "required": [
    "workflow_id",
    "state_id"
  ]
}

ワークフロー遷移 4

workflow_transitions_create write

ユーザー所有ワークフローに状態遷移(A→B)を追加する。状態 id は workflow_states_list から取得。system 所有は不可。

パラメータ 5 · 入力スキーマ
引数必須
workflow_id string yes
from_state_id string no
to_state_id string yes
kind string yes
is_default_next boolean no
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "from_state_id": {
      "type": "string",
      "description": "Source state id. Pass null/omit for the initial transition (entry point)."
    },
    "to_state_id": {
      "type": "string",
      "description": "Destination state id."
    },
    "kind": {
      "type": "string",
      "enum": [
        "next",
        "cancel",
        "manual",
        "reopen"
      ],
      "description": "Transition kind. next=primary progression, cancel=negative terminal, manual=arbitrary, reopen=terminal->initial."
    },
    "is_default_next": {
      "type": "boolean",
      "description": "If true, mark this transition as the default next from from_state. Only valid when kind=\"next\". Any other transition with the same (workflow_id, from_state_id) that is currently the default will be atomically demoted to false. At most one default_next is allowed per from_state."
    }
  },
  "required": [
    "workflow_id",
    "to_state_id",
    "kind"
  ]
}
workflow_transitions_delete write destructive

ユーザー所有ワークフローから遷移を削除する。id は workflow_transitions_list で確認。実行には確認が必要。

パラメータ 2 · 入力スキーマ
引数必須
workflow_id string yes
transition_id string yes
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "transition_id": {
      "type": "string",
      "description": "Transition id from workflow_transitions_list."
    }
  },
  "required": [
    "workflow_id",
    "transition_id"
  ]
}
workflow_transitions_list read

指定状態から出る遷移の一覧。次に取り得る状態の判定に使う。kind や既定の次状態フラグを返す。

パラメータ 1 · 入力スキーマ
引数必須
from_state_id string yes
json
{
  "type": "object",
  "properties": {
    "from_state_id": {
      "type": "string",
      "description": "Workflow state id to query transitions from (typically the current item.status_definition_id)."
    }
  },
  "required": [
    "from_state_id"
  ]
}
workflow_transitions_update write

既存遷移を更新する(kind の変更や既定の次状態フラグの切替)。

パラメータ 4 · 入力スキーマ
引数必須
workflow_id string yes
transition_id string yes
kind string no
is_default_next boolean no
json
{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "description": "Target workflow id (must be user-owned)."
    },
    "transition_id": {
      "type": "string",
      "description": "Transition id from workflow_transitions_list."
    },
    "kind": {
      "type": "string",
      "enum": [
        "next",
        "cancel",
        "manual",
        "reopen"
      ],
      "description": "New transition kind. Omit to leave unchanged."
    },
    "is_default_next": {
      "type": "boolean",
      "description": "Toggle the default-next flag. Only valid for kind=\"next\". When set to true, any other default_next on the same (workflow_id, from_state_id) is demoted to false."
    }
  },
  "required": [
    "workflow_id",
    "transition_id"
  ]
}

ラベル 4

project_labels_create write

プロジェクトにラベル定義(色付き)を作成する。多くの場合 items_create/patch の labels で自動作成されるため不要。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
name string yes
description string no
color_hex string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "name": {
      "type": "string",
      "description": "Label name (max 64 chars)."
    },
    "description": {
      "type": "string",
      "description": "Optional hint on when to apply this label (max 500 chars). Helps later tagging decide whether an item should carry it."
    },
    "color_hex": {
      "type": "string",
      "description": "Optional #RRGGBB color. Omit / null for unset."
    }
  },
  "required": [
    "project_key",
    "name"
  ]
}
project_labels_delete write destructive

プロジェクトのラベル定義を削除する。既定では各アイテムの labels からも除去する。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
label_id string yes
strip_from_items boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "label_id": {
      "type": "string",
      "description": "Label id from project_labels_list."
    },
    "strip_from_items": {
      "type": "boolean",
      "description": "Also remove the label name from items.labels. Default true."
    }
  },
  "required": [
    "project_key",
    "label_id"
  ]
}
project_labels_list read

プロジェクトのラベル定義一覧(id/名称/説明/色/表示順)。patch/delete 前の id 確認に使う。

パラメータ 1 · 入力スキーマ
引数必須
project_key string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\"). Use \"INBOX\" for inbox."
    }
  },
  "required": [
    "project_key"
  ]
}
project_labels_patch write

プロジェクトラベルの名称・説明・色を更新する。改名は既存アイテムの labels にも反映される。

パラメータ 5 · 入力スキーマ
引数必須
project_key string yes
label_id string yes
name string no
description string no
color_hex string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "label_id": {
      "type": "string",
      "description": "Label id from project_labels_list."
    },
    "name": {
      "type": "string",
      "description": "New label name (max 64 chars)."
    },
    "description": {
      "type": "string",
      "description": "New \"when to apply\" hint (max 500 chars). Empty string clears it."
    },
    "color_hex": {
      "type": "string",
      "description": "New #RRGGBB color. Pass null to clear."
    }
  },
  "required": [
    "project_key",
    "label_id"
  ]
}

エリア 5

project_areas_assign_item write

アイテムにエリアを割り当て/クリアする(1 アイテム=0..1 エリア)。area_path で指定する。

パラメータ 2 · 入力スキーマ
引数必須
item_ref string yes
area_path string no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item ref, e.g. \"WORK#42\" or \"#42\"."
    },
    "area_path": {
      "type": "string",
      "description": "Area path within the item's project (e.g. \"API/Auth\"). null / omit to unassign."
    }
  },
  "required": [
    "item_ref"
  ]
}
project_areas_create write

プロジェクトにエリア(製品/機能/責務の階層的な分類軸)を作成する。親配下にネスト可(最大深さ 3)。

パラメータ 4 · 入力スキーマ
引数必須
project_key string yes
name string yes
description string no
parent_path string no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "name": {
      "type": "string",
      "description": "Area name (max 80 chars, no \"/\")."
    },
    "description": {
      "type": "string",
      "description": "Optional one-line scope hint (\"what goes in this area\", max 500 chars). Used as a classification cue when assigning items to areas."
    },
    "parent_path": {
      "type": "string",
      "description": "Optional parent area path (e.g. \"API\"). Omit / null to create a root area. Max depth 3."
    }
  },
  "required": [
    "project_key",
    "name"
  ]
}
project_areas_delete write destructive

エリアを削除する。子エリアや割り当てアイテムがある場合は条件付き(force 等)。データを残すならアーカイブを推奨。

パラメータ 3 · 入力スキーマ
引数必須
project_key string yes
area_path string yes
force boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "area_path": {
      "type": "string",
      "description": "Area path to delete (e.g. \"API/Auth\")."
    },
    "force": {
      "type": "boolean",
      "description": "If true, detach the area from assigned items first, then delete. Default false."
    }
  },
  "required": [
    "project_key",
    "area_path"
  ]
}
project_areas_list read

プロジェクトのエリア定義一覧(id/名称/path/親/説明/表示順)。割り当て前の path 確認に使う。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
include_archived boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\"). Use \"INBOX\" for inbox."
    },
    "include_archived": {
      "type": "boolean",
      "description": "Include archived areas (default false)."
    }
  },
  "required": [
    "project_key"
  ]
}
project_areas_update write

エリアを更新する(改名/説明編集/親の変更/アーカイブ)。area_path で対象を指定する。

パラメータ 6 · 入力スキーマ
引数必須
project_key string yes
area_path string yes
name string no
description string no
new_parent_path string no
archived boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "area_path": {
      "type": "string",
      "description": "Current area path (e.g. \"API/Auth\")."
    },
    "name": {
      "type": "string",
      "description": "New name (rename). Max 80 chars, no \"/\"."
    },
    "description": {
      "type": "string",
      "description": "New scope hint (\"what goes in this area\", max 500 chars). Empty string clears it."
    },
    "new_parent_path": {
      "type": "string",
      "description": "New parent area path to move under. Empty string \"\" = move to root."
    },
    "archived": {
      "type": "boolean",
      "description": "true = archive (hide, keep data); false = restore."
    }
  },
  "required": [
    "project_key",
    "area_path"
  ]
}

カスタムフィールド 4

project_custom_fields_create write

プロジェクトにカスタムフィールド定義を作成する(v1.0 は text のみ)。必須化や表示順も指定できる。

パラメータ 5 · 入力スキーマ
引数必須
project_key string yes
label string yes
field_key string no
is_required boolean no
display_order number no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\")."
    },
    "label": {
      "type": "string",
      "description": "Human-readable field label (max 80 chars)."
    },
    "field_key": {
      "type": "string",
      "description": "Optional stable slug (^[a-z][a-z0-9_]*$, max 64). Used to set values later. Derived from label if omitted."
    },
    "is_required": {
      "type": "boolean",
      "description": "Mark the field as required. Default false."
    },
    "display_order": {
      "type": "number",
      "description": "Ordering hint (lower = earlier). Default 0."
    }
  },
  "required": [
    "project_key",
    "label"
  ]
}
project_custom_fields_delete write destructive

カスタムフィールド定義を無効化(論理削除)する。既存値は保持され、再有効化で復活する。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
field_key string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "field_key": {
      "type": "string",
      "description": "Stable slug of the field to deactivate (from project_custom_fields_list)."
    }
  },
  "required": [
    "project_key",
    "field_key"
  ]
}
project_custom_fields_list read

プロジェクトのカスタムフィールド定義一覧(field_key/label/型/必須など)。値設定前の field_key 確認に使う。

パラメータ 2 · 入力スキーマ
引数必須
project_key string yes
include_inactive boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\"). Use \"INBOX\" for inbox."
    },
    "include_inactive": {
      "type": "boolean",
      "description": "Include logically-deleted (deactivated) fields (default false)."
    }
  },
  "required": [
    "project_key"
  ]
}
project_custom_fields_update write

カスタムフィールド定義を更新する(label 改名/表示順/必須切替/再有効化)。field_key 自体は不変。

パラメータ 6 · 入力スキーマ
引数必須
project_key string yes
field_key string yes
label string no
display_order number no
is_required boolean no
is_active boolean no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key."
    },
    "field_key": {
      "type": "string",
      "description": "Stable slug of the field to update (from project_custom_fields_list)."
    },
    "label": {
      "type": "string",
      "description": "New label (rename). Max 80 chars."
    },
    "display_order": {
      "type": "number",
      "description": "New ordering hint (lower = earlier)."
    },
    "is_required": {
      "type": "boolean",
      "description": "Toggle required flag."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = reactivate a deactivated field; false = deactivate (logical delete)."
    }
  },
  "required": [
    "project_key",
    "field_key"
  ]
}

タスクテンプレート 3

task_templates_list read

ユーザーのタスクテンプレート(定期タスク生成器)一覧。templates_run 前の template_ref 確認に使う。

パラメータ 3 · 入力スキーマ
引数必須
project_key string no
enabled boolean no
limit number no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Filter by project key."
    },
    "enabled": {
      "type": "boolean",
      "description": "Filter by enabled status."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-30, default 20)."
    }
  }
}
templates_create write

RRULE(RFC 5545)で定期的にタスクを自動生成するテンプレートを作成する。単発タスクは items_create を使う。

パラメータ 7 · 入力スキーマ
引数必須
project_key string no
title string yes
detail string no
recurrence_rule string yes
timezone string no
generation_strategy string no
labels array no
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Optional. Existing pinned project key. Omit for Inbox."
    },
    "title": {
      "type": "string",
      "description": "Template title shown in lists (1-200 chars)."
    },
    "detail": {
      "type": "string",
      "description": "Optional default detail/description for generated tasks."
    },
    "recurrence_rule": {
      "type": "string",
      "description": "RFC 5545 RRULE, e.g. \"FREQ=DAILY\" or \"FREQ=WEEKLY;BYDAY=MO\"."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone (default \"Asia/Tokyo\")."
    },
    "generation_strategy": {
      "type": "string",
      "enum": [
        "always",
        "skip_if_previous_open",
        "supersede_previous"
      ],
      "description": "How to handle the previous open instance. Default \"skip_if_previous_open\"."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional labels (default [\"定型\"])."
    }
  },
  "required": [
    "title",
    "recurrence_rule"
  ]
}
templates_run write

テンプレートを今すぐ手動実行してタスクインスタンスを生成する(スケジュールに関係なく)。

パラメータ 1 · 入力スキーマ
引数必須
template_ref string yes
json
{
  "type": "object",
  "properties": {
    "template_ref": {
      "type": "string",
      "description": "Reference of a task_template item, e.g. \"#42\" (prefix optional) or \"WORK#42\"."
    }
  },
  "required": [
    "template_ref"
  ]
}

検索・コンテキスト参照 7

統合検索 1

query read

アイテム・チャットスレッド・メッセージを横断する統合検索。フリーテキスト+DSL フィルタに対応。横断/履歴検索向け(完全一致は items_grep)。

パラメータ 4 · 入力スキーマ
引数必須
q string yes
mode string no
kinds array no
limit number no
json
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free text + DSL filters (e.g. \"deploy status:done due:<2026-05\"). For Japanese, use >= 3 character phrases for trigram FTS."
    },
    "mode": {
      "type": "string",
      "enum": [
        "fulltext",
        "semantic",
        "hybrid"
      ],
      "description": "Default 'fulltext'. Pick 'semantic' / 'hybrid' only when explicitly needed."
    },
    "kinds": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "item",
          "thread",
          "thread_message"
        ]
      },
      "description": "Subset of kinds to search. Omit for all kinds."
    },
    "limit": {
      "type": "number",
      "description": "Per-kind cap (1-30, default 10)."
    }
  },
  "required": [
    "q"
  ]
}

ワークスペース参照 (read-only) 6

activities_list read

特定タスクの変更履歴(タイトル/期日/優先度/完了/アーカイブ/再オープン等)を新しい順に取得する。読み取り専用。

パラメータ 4 · 入力スキーマ
引数必須
item_ref string yes
kind string no
actor_kind string no
limit number no
json
{
  "type": "object",
  "properties": {
    "item_ref": {
      "type": "string",
      "description": "Item reference like \"#42\" (owner-wide number, prefix optional) or \"WORK#42\". Bare \"#42\" resolves the item in any project — no project prefix needed."
    },
    "kind": {
      "type": "string",
      "description": "Optional filter by activity kind (e.g. \"item.completed\", \"item.due_date.changed\", \"item.archived\"). Omit to return all kinds."
    },
    "actor_kind": {
      "type": "string",
      "enum": [
        "human",
        "nyall",
        "agent",
        "system"
      ],
      "description": "Optional filter by who performed the change."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-50, default 20)."
    }
  },
  "required": [
    "item_ref"
  ]
}
item_kinds_list read

プロジェクトが board profile で定義するカスタム work-item kind の一覧。組み込み kind(epic/story/task/bug/chore)は常に使えるため通常は不要。

パラメータ 1 · 入力スキーマ
引数必須
project_key string yes
json
{
  "type": "object",
  "properties": {
    "project_key": {
      "type": "string",
      "description": "Project key (e.g. \"WORK\") whose work-item kinds to list."
    }
  },
  "required": [
    "project_key"
  ]
}
me_overview read

接続直後にまず呼ぶユーザーの俯瞰ビュー。プロジェクト・ステータス語彙・最近の活動・会話要約・週次ペース・未完了タスクを一括で返す。読み取り専用。

パラメータ 2 · 入力スキーマ
引数必須
tz_offset_minutes number no
week_start string no
json
{
  "type": "object",
  "properties": {
    "tz_offset_minutes": {
      "type": "number",
      "description": "Optional. Minutes offset from UTC for the user's local day (e.g. 540 for JST). Used to bucket the weekly pulse / streak by local day. Defaults to 0 (UTC) if omitted."
    },
    "week_start": {
      "type": "string",
      "enum": [
        "sunday",
        "monday"
      ],
      "description": "Optional. Week start for the pulse weekly_done window (this-week boundary). Defaults to \"monday\" if omitted."
    }
  }
}
notifications_list read

ユーザーの最近の通知(既読/未読)を一覧する。既読化はしない。読み取り専用。

パラメータ 2 · 入力スキーマ
引数必須
status string no
limit number no
json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "unread",
        "all"
      ],
      "description": "Default unread."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-30, default 10)."
    }
  }
}
projects_list read

ユーザーのプロジェクト一覧(key/名称/Inbox 判定/説明)。items_create 前のプロジェクト確認に使う。既定でアーカイブ済は除外。

パラメータ 1 · 入力スキーマ
引数必須
include_archived boolean no
json
{
  "type": "object",
  "properties": {
    "include_archived": {
      "type": "boolean",
      "description": "Include archived projects (default false)."
    }
  }
}
settings_list read

ユーザーの LLM/チャット設定を読む(grounding・Context Caching・RAG の有効状態など)。変更はしない。読み取り専用。

パラメータ 1 · 入力スキーマ
引数必須
prefix string no
json
{
  "type": "object",
  "properties": {
    "prefix": {
      "type": "string",
      "description": "Optional key prefix (e.g. \"llm\" / \"chat\") to narrow the result."
    }
  }
}

合計: 88 tools