tasks

name	tasks
description	Tasks tools for Dataspheres AI

Tasks

Tool reference for this resource group, mirrored by hand from the platform live /api/mcp/schema schema.

Tools

auto_tag_task — Auto-Tag Task

LLM-powered auto-tagging — infers tags from task content and the existing tag catalog. Only applies tags that add substantial value for grouping or discoverability.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
taskId	string	yes	Task ID to auto-tag

bulk_create_tasks — Bulk Create Tasks

Use this tool whenever the user wants to add multiple items to their planner — especially when an attached file or image contains a schedule, list of events, agenda, class timetable, workout plan, or any other structured list of items. Extract each item as a separate task with title, dueDate, priority, and status fields. This is the correct tool for "add these to my planner", "create tasks from this schedule", "put these events in my task list", or any variation where the source is an attachment. Each task is created atomically in a single transaction. Max 100 tasks per call.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
tasks	object	yes	Array of task objects: [{ title, status?, priority?, dueDate?, assigneeId?, tags?[] }]. Max 100.

bulk_update_tasks — Bulk Update Tasks

Update fields on multiple tasks at once — status, priority, assignee, due date, or tags. Use tags.add/tags.remove for bulk tag operations.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
taskIds	object	yes	Array of task IDs to update
update	object	yes	{ status?, priority?, assigneeId?, dueDate?, tags?: { add?: string[], remove?: string[] } }

create_plan_mode — Create Plan Mode

Creates create a new plan mode — a named kanban board configuration with custom columns and tag filters. "columns" accepts a fully custom column set [{name, color, isdonestate}]; "template" uses a preset (default, ops, sprint, research, sales, editorial, crm) — "columns" wins when both provided. "tagfilter" is a string array of tags that scopes which tasks appear in this mode — infer it automatically from context (e.g. name="wedding planning" → tagfilter=["wedding"]; name="sprint q2" → tagfilter=["q2"]). templates: default (kanban), ops (business ops), sprint (sprint board), research (research pipeline), sales (sales pipeline), editorial (editorial calendar), crm (crm contract pipeline).. Requires MODERATOR+ role in the datasphere. Required fields: datasphereId (string); name (string). Optional: template (default|ops|sprint|research|sales|editorial|crm), columns, tagFilter. Show a preview of the operation and get explicit confirmation from the user before executing.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
name	string	yes	Plan mode name (e.g. "Sprint Q2", "Wedding Planning", "Content Pipeline")
template	string	no	Template: default | ops | sprint | research | sales | editorial | crm
columns	array	no	Custom columns: [{name, color, isDoneState}]. Overrides template when provided.
tagFilter	array	no	Tag slugs that scope which tasks appear in this mode. Infer from the plan name — e.g. "Wedding Planning" → ["wedding"], "Sprint Q2" → ["q2", "sprint"]. Pass [] for no filter (all tasks visible).

create_status_group — Create Status Group

Creates create a new task status group (a single kanban column inside a plan mode, not a plan mode itself). use create_plan_mode to create a named board configuration with multiple columns. always include planmodeid when adding a column to an existing plan mode.. Requires MODERATOR+ role in the datasphere. Required fields: datasphereId (string); name (string). Optional: color, planModeId, isDoneState. Show a preview of the operation and get explicit confirmation from the user before executing.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
name	string	yes	Status group name
color	string	no	Color hex code for the status group
planModeId	string	no	Plan mode ID this column belongs to — required when adding a column to a specific plan mode
isDoneState	boolean	no	Mark this column as the terminal "done" state

create_task — New Task

Creates a new task in a datasphere planner. Gather title (required), optional content, priority, status, due date, reminder, assignee, and tagNames.

PREVIEW CARD MUST INCLUDE: datasphereUri, title, status, priority. Optional but recommended: dueDate, assigneeId, tagNames. FIELD RULES: Use exact lowercase field names only. Do not invent extra fields.

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
title	string	yes	Task title
content	string	no	Task description (rich text)
status	string	no	Status
priority	string	no	Priority
dueDate	string	no	Due date (ISO 8601)
reminderAt	string	no	Reminder date/time (ISO 8601)
reminderRecurrence	string	no	Reminder recurrence
assigneeId	string	no	Assign to a user ID
tagNames	array	no	Tag names to apply (e.g. ["Early Adopter", "Q2"]). Each is found or created automatically.

create_task_comment — Add Task Comment

Creates adds a comment to a task. Requires MODERATOR+ role in the datasphere. Required fields: datasphereUri (string); taskId (string); content (string) — max 10000 chars. Show a preview of the operation and get explicit confirmation from the user before executing.

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
taskId	string	yes	Task ID
content	string	yes	Comment text (max 10,000 chars)

delete_task — Delete Task

Deletes a task. Only the task creator or moderators can delete. Always confirm with user before deleting.

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
taskId	string	yes	Task ID to delete

extract_task_from_document — Extract Task from Document

Creates ai-powered task extraction from document text. Requires MODERATOR+ role in the datasphere. This operation costs tokens — always confirm with the user before executing. Required fields: datasphereId (string); documentId (string). Show a preview of the operation and get explicit confirmation from the user before executing.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
documentId	string	yes	Document ID to extract tasks from

get_task — Get Task

Retrieves gets full task detail including content, source document, and status group. Requires MODERATOR+ role in the datasphere. Required fields: datasphereUri (string); taskId (string).

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
taskId	string	yes	Task ID

list_plan_mode_templates — List Plan Mode Templates

Retrieves returns the built-in template catalog with column structure for each template (default, ops, sprint, research, sales, editorial, crm). use this before creating a plan mode to understand what columns each template provides.. Requires PARTICIPANT+ role in the datasphere. Required fields: datasphereId (string).

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID

list_plan_modes — List Plan Modes

Retrieves list all plan modes (named kanban board configurations) for this datasphere. returns each mode with its statusgroups (columns) including name, color, sortorder, isdefault, isdonestate — use this to understand what boards exist and their column structure before creating tasks or managing workflows.. Requires PARTICIPANT+ role in the datasphere. Required fields: datasphereId (string).

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID

list_scheduled_jobs — Scheduled Jobs

Lists all scheduled/recurring jobs in a datasphere — sequences, URL monitors, newsletters, and task reminders. Returns unified view sorted by next run time.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID

list_task_comments — List Task Comments

Retrieves lists comments on a task. Requires MODERATOR+ role in the datasphere. Required fields: datasphereUri (string); taskId (string).

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
taskId	string	yes	Task ID

list_tasks — List Tasks

Lists tasks in a datasphere. Can filter by status (TODO, IN_PROGRESS, IN_REVIEW, DONE, BLOCKED, CANCELLED), priority (LOW, MEDIUM, HIGH, URGENT), and assignee.

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
status	string	no	Filter by status
priority	string	no	Filter by priority
assigneeId	string	no	Filter by assignee user ID

search_tasks_v2 — Search Tasks

Retrieves search tasks by text and code tag filters. Requires PARTICIPANT+ role in the datasphere. Required fields: datasphereId (string). Optional: q.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
q	string	no	Search query text

update_plan_mode — Update Plan Mode

Updates update an existing plan mode — rename it, change its tag filter, or replace/append its columns. important: call list_plan_modes first to read the current column set before sending "columns" — "columns" is a full replace (the list you send becomes the entire column set; any column not in the list is deleted and its tasks remapped to column[0]). tasks in removed columns automatically move to the first column in the new list. "addcolumns" is append-only — safe to use without reading first. "tagfilter" fully replaces the current filter (pass [] to clear). suggest tagfilter updates proactively when the user describes a themed board that has none set.. Requires MODERATOR+ role in the datasphere. Required fields: datasphereId (string); modeId (string). Optional: name, tagFilter, columns, addColumns. Show a preview of the operation and get explicit confirmation from the user before executing.

Field	Type	Required	Description
datasphereId	string	yes	Datasphere ID
modeId	string	yes	Plan mode ID to update
name	string	no	New plan mode name
tagFilter	array	no	Full replacement tag filter — e.g. ["wedding"] scopes this board to wedding-tagged tasks. Pass [] to clear.
columns	array	no	FULL REPLACE — [{name, color, isDoneState}]. Read current columns via list_plan_modes first. Omitted columns are deleted; their tasks move to column[0].
addColumns	array	no	APPEND ONLY — [{name, color, isDoneState}]. Adds new columns without touching existing ones.

update_task — Update Task

Updates an existing task. Can change title, status, priority, due date, reminder, assignee. Pass tagNames array to add tags (existing tags are kept). Only send fields that should change.

Field	Type	Required	Description
datasphereUri	string	yes	Datasphere URI
taskId	string	yes	Task ID to update
title	string	no	New title
status	string	no	New status
priority	string	no	New priority
dueDate	string	no	New due date (ISO 8601)
reminderAt	string	no	Reminder date/time (ISO 8601). Pass null to clear.
reminderRecurrence	string	no	Reminder recurrence. Pass null to clear.
assigneeId	string	no	Reassign to user ID