Reference

MCP tools reference

Every tool the connector exposes — 71 across 12 domains. Read-only and destructive hints follow MCP annotations, so clients can render the right confirmations.

readnever changes anythingwritecreates or updatesdestructivedeletes — clients confirm first

tasks.assignwrite

Assign or unassign a task. Pass `assigneeId: null` to clear.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required
assigneeId	any	required	User id to assign, or null to unassign.

tasks.createwrite

Create a task in a project. Auto-assigns the caller and auto-subscribes them to the task. Defaults to the workspace's default status when statusId is omitted.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
projectId	string	required
body	object	required
body.title	string	required
body.description	any	optional	Task description as a BlockNote / TipTap JSON block array (same shape as comments.create content). null clears.
body.statusId	string	optional
body.priority	string: urgent \| high	optional	Optional priority. Tasks default to no priority.
body.assigneeId	any	optional
body.dueDate	any	optional	ISO 8601 date (YYYY-MM-DD). null clears.
body.milestoneId	any	optional

tasks.deletedestructive

Delete a task. Comments / linked-docs follow the existing cascade.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.getread

Fetch a single task's full detail.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.listread

List tasks in a project. Filters: status / priority / assignee / creator / label / milestone (include, exclude, is-empty variants), due-date ranges, and title search (titleContains). Array filters combine as AND across fields, OR within a field. Pagination: limit (default 50, max 200), offset.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
projectId	string	required	Project id.
statusId	string	optional	Single-status filter; prefer statusIds.
statusIds	string[]	optional	Tasks in ANY of these statuses.
excludeStatusIds	string[]	optional
priority	string: urgent \| high	optional	Single-priority filter; prefer priorities.
priorities	string[]	optional
excludePriorities	string[]	optional
priorityIsEmpty	boolean	optional	Only tasks with no priority.
priorityIsNotEmpty	boolean	optional
assigneeIds	string[]	optional
excludeAssigneeIds	string[]	optional
assigneeIsEmpty	boolean	optional	Only unassigned tasks.
assigneeIsNotEmpty	boolean	optional
creatorIds	string[]	optional
excludeCreatorIds	string[]	optional
labelIds	string[]	optional	Tasks with ANY of these labels.
labelIdsAll	string[]	optional	Tasks with ALL of these labels.
excludeLabelIds	string[]	optional
labelsIsEmpty	boolean	optional
labelsIsNotEmpty	boolean	optional
milestoneId	string	optional	Single-milestone filter; prefer milestoneIds.
milestoneIds	string[]	optional
excludeMilestoneIds	string[]	optional
milestoneIsEmpty	boolean	optional
milestoneIsNotEmpty	boolean	optional
dueOn	string	optional
dueBefore	string	optional	Exclusive upper bound (YYYY-MM-DD).
dueAfter	string	optional	Exclusive lower bound (YYYY-MM-DD).
dueFrom	string	optional	Inclusive lower bound (YYYY-MM-DD).
dueTo	string	optional	Inclusive upper bound (YYYY-MM-DD).
dueIsEmpty	boolean	optional
dueIsNotEmpty	boolean	optional
titleContains	string	optional	Case-insensitive title search.
titleStartsWith	string	optional
titleNotContains	string	optional
sort	string: created_at \| updated_at \| due_date \| priority \| status \| title \| number	optional
order	string: asc \| desc	optional
limit	integer	optional
offset	integer	optional

tasks.mutewrite

Silence a task's notifications even where they would arrive automatically. The only way to opt out of a task you are assigned to.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.set_labelswrite

Replace the full label set on a task. Pass an empty array to clear all labels.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required
labelIds	string[]	required	Full label set for the task. Replaces existing labels. Pass [] to clear.

tasks.set_statuswrite

Move a task to a different status. Sugar over `tasks.update` for the agent's most common write — pair with `comments.create` for narration.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required
statusId	string	required	Target status id (from `statuses.list`).

tasks.unmutewrite

Lift a mute and restore whatever watch state applied before it.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.unwatchwrite

Drop an explicit watch. A task still watched automatically (assignee, author) keeps notifying — use tasks.mute to silence those.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.updatewrite

Partial update on a task (title, description, status, priority, assignee, due date, milestone). Status changes, assignee changes, and field edits emit activity-log entries and notifications to watchers.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required
body	object	required
body.title	string	optional
body.description	any	optional	Task description as a BlockNote / TipTap JSON block array (same shape as comments.create content). null clears.
body.statusId	string	optional
body.priority	any	optional	Priority, or null to clear.
body.assigneeId	any	optional
body.dueDate	any	optional	ISO 8601 date (YYYY-MM-DD). null clears.
body.milestoneId	any	optional

tasks.watchwrite

Explicitly subscribe to a task's notifications. Idempotent.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.watch_getread

Get the caller's watch state for a task: watching, muted, and whether the watch is automatic (`auto` — derived from being assignee or author).

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
taskId	string	required

tasks.watched_listread

List the ids of every task the caller watches in a workspace (muted ones included) — for marking watch state across a task list without a request per task.

Parameter	Type	Required	Description
workspaceSlug	string	required	Workspace slug (from workspaces.list).
limit	integer	optional
offset	integer	optional

Each tool advertises its full JSON schema via tools/list — for exact arguments use your client's tool inspector; in Claude Code that's /mcp