Tasks
Space MCP tools in the Tasks scope (tasks). Reach these with a wks_live_ key over space-mcp or space-api.
Tools in the tasks scope, callable over space-mcp (tools/call) or space-api (REST) with a wks_live_* key that grants tasks.
create_task
Scope: tasks:write
Create a task. Requires title. Optional: description, instructions, priority (low|normal|high|urgent), due_at (ISO), project_id. To make an agent DO the task, assign it: assigned_to_cloud_agent_id or assigned_to_workspace_id (see list_agents), or assign_to_self=true to assign to yourself (computer agents only). An assigned agent starts working automatically.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | yes | |
description | string | ||
instructions | string | ||
priority | low | normal | high | urgent | ||
due_at | string | ||
project_id | string | ||
assigned_to_cloud_agent_id | string | Cloud agent id to assign + run the task (from list_agents). | |
assigned_to_workspace_id | string | Space Computer Agent workspace id to assign + run the task (from list_agents). | |
assign_to_self | boolean | Assign the task to yourself (Space Computer Agents only). |
list_agents
Scope: tasks:read
List agents you can assign a task to. Returns cloud_agents (use the assigned_to_cloud_agent_id field with create_task) and computer_agents (Space Computer Agents; use assigned_to_workspace_id). An assigned agent automatically runs the task.
list_task_projects
Scope: tasks:read
List task projects/boards in the space.
list_tasks
Scope: tasks:read
List space tasks. Optional status (todo|in_progress|done|cancelled|blocked) and project_id.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | todo | in_progress | done | cancelled | blocked | ||
project_id | string | ||
limit | number |
update_task
Scope: tasks:write
Update a task by id (status, title, description, priority, result, project_id).
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | yes | |
status | todo | in_progress | done | cancelled | blocked | ||
title | string | ||
description | string | ||
priority | low | normal | high | urgent | ||
result | string | ||
project_id | string |