Read a project board with get_project_items
Goal: list every item on a Projects v2 board along with its field values, to find an item’s node ID or inspect board state.
Prerequisites
Section titled “Prerequisites”- You know the project’s owner login, number, and owner type.
- No
projectscope check is performed by this tool itself (it’s a read); a token without at least read access to the project will fail at the API call. - This tool fetches at most the board’s first 100 items in a single,
unpaginated GraphQL query. A board with more than 100 items silently
returns only the first 100 — there is no cursor or
hasNextPagesignal to detect the truncation.
-
Call
get_project_items:{ "projectOwnerLogin": "your-org", "projectNumber": 1 } -
Read the response:
{"items": [{"id": "PVTI_...","title": "Fix flaky upload retry","number": 101,"repo": "your-org/your-repo","fieldValues": [{ "fieldName": "Status", "optionName": "In Progress" }]}]}
Verify it worked
Section titled “Verify it worked”- Cross-check a few items’
title/numberagainst what you see on the board in the browser. - If the board holds items from more than one repository, always match
items by both
numberandrepo, notnumberalone — two repos on the same board can share an issue number, andnumberalone is not a safe join key. - A
DraftIssueitem hasnumber: nullandrepo: null— it has neither.
See also: tool reference.