list_issues
Fetch Redmine issues with flexible filters for project, status, assignee, author, dates, and custom fields. Includes total count to plan pagination.
Instructions
List Redmine issues, with filters.
Args: project_identifier: project identifier. Empty = all projects. status: 'open', 'closed', '*' (all), or the ID of a specific status. limit: maximum issues per page. Redmine caps this at 100. tracker_id: filter by tracker (use list_trackers). category_id: filter by category (use list_project_categories). fixed_version_id: filter by target version (use list_project_versions). assigned_to_id: filter by assignee. author_id: filter by who created the issue. parent_issue_id: return the subtasks of an issue. subject_contains: text contained in the subject (partial match). created_after: YYYY-MM-DD, issues created on or after this date. created_before: YYYY-MM-DD, issues created on or before this date. updated_after: YYYY-MM-DD, issues updated on or after this date. custom_fields: map of {field_id: value}, e.g. {"1": "8"}. sort_by: field and direction, e.g. 'priority:desc', 'updated_on:desc', 'id:asc'. Several can be comma-separated. offset: how many issues to skip — use together with 'limit' to paginate. query_id: run a saved query (use list_saved_queries). When given, the other filters are ignored by Redmine.
Returns: JSON with the total number of matching issues (not just this page), so it's possible to tell whether pagination is needed without guessing.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_issues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| status | No | open | |
| sort_by | No | ||
| query_id | No | ||
| author_id | No | ||
| tracker_id | No | ||
| category_id | No | ||
| created_after | No | ||
| custom_fields | No | ||
| updated_after | No | ||
| assigned_to_id | No | ||
| created_before | No | ||
| parent_issue_id | No | ||
| fixed_version_id | No | ||
| subject_contains | No | ||
| project_identifier | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |