List Things 3 Todos
things3_get_todosList todos from Things 3 with filters for status, project, area, tag, or search text. Supports pagination with limit and offset.
Instructions
List todos from Things 3 with optional filters and pagination.
Returns todos matching the specified criteria. Use "status" to filter by list (inbox, today, upcoming, anytime, someday, logbook). Combine with projectId, areaId, tag, or search filters to narrow results.
Args:
status: Filter by Things 3 list name
projectId: Filter by project ID (get IDs from things3_get_projects)
areaId: Filter by area ID (get IDs from things3_get_areas)
tag: Filter by tag name (get names from things3_get_tags)
search: Case-insensitive substring match against title and notes
limit: Max results to return (default 50, max 200)
offset: Number of results to skip for pagination (default 0)
Returns: { items: Todo[], total_available, offset, limit, has_more }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter by tag name | |
| limit | No | Max results to return (default 50) | |
| areaId | No | Filter by area ID | |
| offset | No | Number of results to skip for pagination | |
| search | No | Case-insensitive substring match against title and notes | |
| status | No | Filter by Things 3 list | |
| projectId | No | Filter by project ID |