List Tasks
list_tasksRetrieve tasks filtered by entity, assignee, status, priority, due date, or tags. Check the render field for tiered guidance on composing your reply.
Instructions
List tasks with rich filtering. Omitting scope returns both org tasks and the caller's personal tasks. Filter by entity_type + entity_id to see tasks linked to a specific customer, transaction, etc. Use assigned_to='@claude' to surface the AI work queue. Response includes a render field with tiered rendering guidance - check it before composing your reply.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Convenience filter for a single tag. Use `tags` for multiple. | |
| tags | No | Filter to items carrying these tags. Combined per `tag_match` (default 'all': the item must carry every listed tag). | |
| limit | No | Max results. Defaults to 50. | |
| scope | No | Filter by scope. Omit to return both org and caller's personal tasks. | |
| status | No | Filter by status. | |
| priority | No | Filter by priority. | |
| timezone | No | IANA timezone string (e.g. 'America/New_York'). When provided, 'today' is computed in the user's local timezone rather than UTC. Affects overdue_only filter. | |
| due_after | No | Return tasks due on or after this date (YYYY-MM-DD). | |
| entity_id | No | Filter to tasks linked to this entity ID. Requires entity_type. | |
| tag_match | No | How to combine `tags`: 'all' (item has every tag, default) or 'any' (item has at least one of them). | |
| created_by | No | Filter by creator user ID. | |
| due_before | No | Return tasks due on or before this date (YYYY-MM-DD). | |
| assigned_to | No | Filter by assignee. Use a user ID, '@claude', '@gpt', or 'unassigned'. | |
| entity_type | No | Filter to tasks linked to this entity type. | |
| overdue_only | No | If true, only return tasks past their due date that are not done. |