list_work_packages
List work packages from OpenProject using filters for status, assignee, dates, priority, and more. Supports sorting, grouping, and selecting specific fields.
Instructions
List work packages with structured filters and no free-text query requirement.
version_status filters by the status of a work package's assigned version: one of 'open', 'closed', or 'locked'.
assignee filters by any user (username, id, or "me"). assignee_me takes precedence.
status/priority filter by name or numeric ID (case-insensitive).
Date filters accept YYYY-MM-DD format:
created_on/updated_on/due_on: exact date match
created_between/updated_between/due_between: inclusive date range [start, end] Cannot specify both _on and _between for the same field.
sort_by accepts a list of sort criteria in format "field:direction" (e.g., ["status:desc", "priority:asc"]). Direction defaults to "asc" if omitted. Common sortable fields: id, subject, status, priority, type, assignee, author, created_at, updated_at, start_date, due_date.
group_by accepts a field name to group results by (e.g., "status", "assignee"). Common groupable fields: status, priority, type, assignee, author, version, category.
select restricts each result row to the given fields (e.g. ["id", "subject", "status"]); an invalid name returns the allowed set. Common fields: id, display_id, subject, type, status, priority, assignee, project, version, parent_id, start_date, due_date, estimated_time, spent_time, created_at, updated_at, author, category, description.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| limit | No | ||
| due_on | No | ||
| offset | No | ||
| select | No | ||
| status | No | ||
| project | No | ||
| sort_by | No | ||
| version | No | ||
| assignee | No | ||
| group_by | No | ||
| priority | No | ||
| open_only | No | ||
| created_on | No | ||
| updated_on | No | ||
| assignee_me | No | ||
| due_between | No | ||
| version_status | No | ||
| created_between | No | ||
| updated_between | No |