コンテンツにスキップ
UTSUROIUTSUROI ドキュメント

ツールリファレンス

UTSUROI の MCP サーバーが公開しているツールの一覧です。

このページは backend のツール定義から自動生成しています。名前・説明・引数は MCP クライアントが実際に受け取るものと同じです（英語のままにしてあるのはそのためです）。

スコープの説明はMCP をつなぐにあります。

読み取りmcp:tasks.read

read スコープだけで呼べます。AI に読ませるだけなら、このスコープに絞るのが安全です。

get_board_context

Get a board and its lanes, labels, and projects for task creation and updates. The board includes a direct UTSUROI URL.

  • boardIdstringrequired
get_task

Get one UTSUROI task by ID from the authorized tenant. The task includes a boardId and a direct UTSUROI URL.

  • idstringrequired
list_boards

List boards in the authorized UTSUROI tenant. Each board includes a direct UTSUROI URL.

引数: なし

list_due_tasks

List tasks by due date range. Use dueDateTo for overdue/today/week queries. Each task includes a boardId and a direct UTSUROI URL.

  • boardIdstring
  • dueDateFromstring
  • dueDateTostring
  • includeArchivedboolean
  • limitinteger
list_labels

List labels for a board in the authorized tenant.

  • boardIdstringrequired
list_lanes

List lanes for a board in the authorized tenant.

  • boardIdstringrequired
list_members

List active members in the authorized tenant for assignee and ball holder updates.

引数: なし

list_my_tasks

List tasks assigned to or held by the authorized user across all accessible boards by default. Set perspective to created for tasks created by the user, or assigned-or-created for both. Open tasks are returned by default. Each task includes board and lane context plus a direct UTSUROI URL. Follow nextCursor with the same filters until it is null to retrieve every page.

  • boardIdstring
  • perspectivestring
  • statusstring
  • cursorstring
  • includeArchivedboolean
  • limitinteger
list_projects

List projects for a board in the authorized tenant.

  • boardIdstringrequired
list_recent_task_events

List recent task history events across the authorized tenant, optionally scoped to a board. Each event includes a direct URL to its task.

  • boardIdstring
  • limitinteger
list_recurring_tasks

List active recurring task templates in the authorized tenant.

引数: なし

list_task_activities

List all task activity in the authorized tenant with cursor pagination. Filter by board, task, actor, event kind, or time range. Archived tasks are included and each activity includes a direct task URL. Follow nextCursor until it is null to retrieve the complete result set.

  • cursorstring
  • limitinteger
  • boardIdstring
  • taskIdstring
  • actorIdstring
  • kindsarray
  • fromAtinteger
  • toAtinteger
search_tasks

Search UTSUROI tasks in the authorized tenant by title or description. Each task includes a boardId and a direct UTSUROI URL.

  • querystring
  • boardIdstring
  • includeArchivedboolean
  • limitinteger

書き込みmcp:tasks.write

write スコープが必要です。加えて、viewer ロールのユーザーは呼べません。

add_task_comment

Add a comment to a task and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • bodystringrequired
archive_task

Soft-archive a task, optionally including subtasks, and return the target task URL. Requires mcp:tasks.write.

  • idstringrequired
  • includeDescendantsboolean
create_label

Create a label on a board and return the board URL. Color is optional and defaults to a preset when omitted. Requires mcp:tasks.write.

  • boardIdstringrequired
  • namestringrequired
  • colorstring
create_project

Create a project on a board and return the board URL. Color is optional and defaults to a preset when omitted. Requires mcp:tasks.write.

  • boardIdstringrequired
  • namestringrequired
  • colorstring
create_recurring_task

Create a recurring task template that auto-generates tasks on a daily/weekly/monthly schedule and return its board URL. Requires mcp:tasks.write.

  • boardIdstringrequired
  • laneIdstringrequired
  • titlestringrequired
  • frequencystringrequired
  • descriptionstring
  • projectIdany
  • sizestring
  • ballHolderIdany
  • assigneeIdsarray
  • labelIdsarray
  • runHourinteger
  • weekdaysarray
  • dayOfMonthinteger
  • timezonestring
  • startOffsetDaysinteger
  • dueOffsetDaysinteger
  • endDateany
  • enabledboolean
create_task

Create a task in the authorized tenant and return its direct UTSUROI URL. Assignees, ball holder, and labels can be set at creation time. Requires mcp:tasks.write.

  • boardIdstringrequired
  • laneIdstringrequired
  • titlestringrequired
  • descriptionstring
  • dueDatestring
  • startDatestring
  • parentIdany
  • projectIdany
  • sizestring
  • orderinteger
  • assigneeIdsarray
  • ballHolderIdany
  • labelIdsarray
create_tasks

Create multiple tasks in the authorized tenant. Returns created items with direct UTSUROI URLs and failed items by input index. Requires mcp:tasks.write.

  • itemsarrayrequired
move_task

Move a task to another lane/parent/order and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • laneIdstringrequired
  • parentIdany
  • orderintegerrequired
restore_task

Restore a soft-archived task, optionally including subtasks, and return the target task URL. Requires mcp:tasks.write.

  • idstringrequired
  • includeDescendantsboolean
set_task_assignees

Replace task assignees and ball holder and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • assigneeIdsarray
  • ballHolderIdany
set_task_labels

Replace task labels and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • labelIdsarray
update_task_fields

Update base task fields such as title, description, dates, project, or size and return the task URL. Requires mcp:tasks.write.

  • idstringrequired
  • titlestring
  • descriptionany
  • dueDateany
  • startDateany
  • baselineStartDateany
  • baselineDueDateany
  • projectIdany
  • sizeany

ボード設定（オプトイン）mcp:boards.settings

既定では公開されません。このスコープを明示的に許可したときだけ tools/list に現れます。

get_board_settings

Read board settings, card defaults, Slack mappings and notification configuration. Requires mcp:boards.settings.

  • boardIdstringrequired
list_board_slack_channels

Discover Slack channel candidates. available=false means the channel is linked to another board and cannot be selected for a mapping. Requires mcp:boards.settings.

  • boardIdstringrequired
set_board_slack_channels

Replace this board's complete Slack channel mappings. Read current settings and merge for add/remove requests. Other boards and workspace Slack settings are preserved. May join the Slack bot to selected channels. Requires mcp:boards.settings.

  • boardIdstringrequired
  • mappingsarrayrequired
set_board_slack_comment_notify_config

Set whether card comments are sent to Slack and optionally change the destination channel. Omitted channelId is preserved. Requires mcp:boards.settings.

  • enabledbooleanrequired
  • channelIdany
  • boardIdstringrequired
set_board_slack_unresponded_config

Replace enabled state and the complete channelIds selection for unanswered mentions. Channels must already be linked to this board. Requires mcp:boards.settings.

  • enabledbooleanrequired
  • channelIdsarray
  • boardIdstringrequired
update_board_settings

Partially update basic settings, card defaults or Slack notification fields. Omitted fields are preserved; cardDefaults replaces the complete defaults object. Does not change board access, recurring tasks or archive state. Requires mcp:boards.settings.

  • namestring
  • colorstring
  • sizingEnabledboolean
  • sizePointsany
  • countUnsizedTasksAsOneboolean
  • cardDefaultsany
  • cardDefaultsApplyToSlackboolean
  • slackDueNotificationEnabledboolean
  • slackDueNotificationHourinteger
  • slackDueNotificationTimezonestring
  • slackDueNotificationChannelIdany
  • slackDueNotificationChannelEnabledboolean
  • slackDueNotificationChannelHourinteger
  • slackDueNotificationChannelThreadEnabledboolean
  • slackCompletionChannelEnabledboolean
  • slackCompletionChannelIdany
  • slackTaskTriggerReactionstring
  • slackUnrespondedTaskEnabledboolean
  • slackUnrespondedAiJudgeEnabledboolean
  • slackAiRoutingEnabledboolean
  • slackAiTitleEnabledboolean
  • slackDueNotificationMethodstring
  • slackDueNotificationDmMethodstring
  • slackDueNotificationChannelMethodstring
  • groupany
  • boardIdstringrequired