MCP tools reference

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

Count a project's tasks per assignee, with the same filters as `tasks.list`. Unassigned tasks are left out.

Permanently delete many tasks at once. Each task is authorized on its own, as a single delete would be.

Apply one change to many tasks at once: set status, priority, assignee, due date or milestone, and add / remove / clear labels. Each task is authorized on its own, as a single update would be.

Count the tasks in a project that match the same filters as `tasks.list` (limit, offset and sort do not apply).

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.

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

Fetch a single task's full detail.

Fetch a task by the number shown in the app (#42) within its project — the way people refer to tasks.

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; use `tasks.count` for the filtered total.

List tasks across every project of a workspace, optionally limited to a due-date range (dueFrom / dueTo) and one assignee. For full filtering use `tasks.list` per project.

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

Pin a task for the caller only (pins are private). Idempotent. List pinned-first with `tasks.list` `sort: pinned`.

List the ids of every task the caller has pinned in a workspace.

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

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

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

Remove the caller's pin from a task. Idempotent.

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

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.

Explicitly subscribe to a task's notifications. Idempotent.

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

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.