comfyui_get_history
Read-onlyIdempotent
Retrieve paginated ComfyUI execution history to review past jobs and workflow runs. Supports offset and limit for browsing arbitrarily far back, returning paged results with a has_more flag.
Instructions
Browse ComfyUI execution history (read-only).
Uses server-side `/history?offset=N&max_items=M` so callers can page
arbitrarily far back. The tool requests one extra entry per page so it
can set ``has_more`` without an additional round-trip.
Args:
limit: Maximum number of results to return (default: 25, max: 100)
offset: Zero-based starting index (default: 0)
Returns:
Envelope with keys ``items``, ``count`` (items in this page),
``offset``, ``limit``, ``has_more``, and ``total``.
``total`` is set only when we can prove the true count:
- ``offset + count`` on the last page when ``count > 0``
(the upstream returned at most ``limit`` entries, so we've seen
everything from ``offset`` onward).
- ``0`` when ``offset == 0`` and the upstream returned nothing
(history is genuinely empty).
- ``None`` otherwise (``has_more`` is True, OR we paged past the
end and got back an empty result — in the latter case the true
count is somewhere in ``[0, offset]`` and we can't tell which).
``has_more`` is the canonical end-of-history signal.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return (1-100, default varies by tool). | |
| offset | No | Zero-based starting index for pagination. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||