motion_tasks
Create, list, update, delete, move, or unassign tasks in Motion. Filter tasks by status, assignee, priority, due date, labels, and more.
Instructions
Manage Motion tasks - supports create, list, get, update, delete, move, unassign, and list_all_uncompleted operations
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Task name (required for create, optional for list as case-insensitive substring search) | |
| limit | No | Maximum number of tasks to return (for list and list_all_uncompleted) | |
| labels | No | Filter by labels (for list). Array of label names | |
| status | No | Filter by status (for list). Single string or array of strings (e.g., ["Todo", "Completed"]). Without status or includeAllStatuses, only active (non-resolved) tasks are returned. Use motion_statuses to list valid values per workspace. | |
| taskId | No | Task ID (required for get/update/delete/move/unassign) | |
| dueDate | No | Due date (for create/update) or filter (for list, filtered client-side — returns tasks due on or before this date). Date-only values are stored as end-of-day UTC. Format: YYYY-MM-DD or relative like 'today', 'tomorrow' | |
| assignee | No | Filter by assignee name, email, or 'me' shortcut (for list and list_all_uncompleted). Resolved to an ID automatically | |
| duration | No | Minutes (as number) or 'NONE'/'REMINDER' (as string) | |
| priority | No | Filter by priority level (for list, filtered client-side): ASAP, HIGH, MEDIUM, LOW | |
| operation | Yes | Operation to perform | |
| projectId | No | Filter by project (for list) | |
| assigneeId | No | Filter by assignee (for list/list_all_uncompleted), set assignee (for create/update), or reassign (for move) | |
| description | No | Task description | |
| projectName | No | Project name (alternative to projectId) | |
| workspaceId | No | Filter by workspace (for list) | |
| autoScheduled | No | Auto-scheduling configuration. Can be either: - A schedule name string: "Work Hours" (simple, no start date) - An object for full control: {"schedule": "Work Hours", "startDate": "2025-03-05", "deadlineType": "SOFT"} When the user specifies a start date, you MUST use the object form. Use motion_schedules to see available schedule names. | |
| workspaceName | No | Filter by workspace name (for list) | |
| targetWorkspaceId | No | Target workspace ID (required for move operation). Move transfers a task between workspaces — project-level targeting is not supported by the Motion API. | |
| includeAllStatuses | No | When true, returns tasks across all statuses including completed/resolved (for list). Cannot be combined with status filter. |