List work package comments
list_work_package_commentsGet the full comment thread and change history for any work package, including author, text, and field updates (e.g., status changes).
Instructions
Read the comment thread and change history of a work package.
Use this whenever the question is "what did people say about this
ticket" or "what changed on it": it returns the full activity journal —
comment entries (author, markdown text, internal flag, timestamps) and
field-change entries whose details are parsed into
{field, from, to} (for example
{"field": "Status", "from": "New", "to": "In progress"}).
Returns the standard list envelope: items plus
pagination{total,page,page_size,has_more} and notes.
Pitfalls. OpenProject's activities endpoint is unpaginated — this
tool fetches the entire journal on every call and pages it here, so
page/page_size cost the same upstream but keep the reply small.
Entries are ordered oldest first, so ask for the last page to see the
latest discussion. Comment text is cut at max_comment_chars and
marked truncated: true; pass that entry's id back as
activity_id to read it in full.
Cross-references: post a comment with add_work_package_comment; the
work package itself (description, custom fields, watchers) comes from
get_work_package; files referenced in a comment are listed by
list_attachments.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Work package id. Get it from search_work_packages, list_work_packages or get_work_package — never guess it. | |
| page | No | 1-based page number over the journal. Entries are oldest first, so the newest comments are on the LAST page. | |
| page_size | No | Journal entries per page, 1-100. Keep it small: comments are long. | |
| activity_id | No | Read exactly one journal entry, uncapped, instead of a page. The id comes from a previous call to this tool. Must belong to work package `id`. | |
| max_comment_chars | No | Per-comment character cap, 50-50000. A cut comment comes back with truncated=true and comment_length; re-read it in full via activity_id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sums | No | Present only when show_sums was requested. | |
| items | No | The page of results. | |
| notes | No | Degradation markers: capped aggregations, unavailable modules, … | |
| groups | No | Present only when group_by was requested. | |
| pagination | Yes | Total/page/page_size/has_more. |