Projects
Projects works with the task boards of GitHub Projects. It reads the boards of an organisation or a user and their tasks, creates new tasks, changes their status (for example from Todo to In progress) or any other field of the board, and archives them. A task can be a draft, with a title and notes, or an issue or pull request that already exists.
When to use it
- An agent that, in a meeting or a chat, writes the agreed tasks on the project’s board.
- Moving a task to
Donewhen it is deployed or when someone asks. - A report of the tasks in progress, pending, or of one person.
- Creating a new board for a project.
Configuration
You need a GitHub API credential. An organisation’s boards need a token with that organisation’s Projects permission (read, or read and write to create and change). Personal boards need a classic token with the project scope, because fine-grained tokens cannot reach them. See Credentials.
| Field | What it does |
|---|---|
| Credential (required) | The GitHub API credential. |
| Operation (required) | List Projects, List Fields, List Items, Create Item, Update Item, Archive Item or Create Project. |
| Owner (required) | The organisation or user that owns the boards, as in github.com/<owner>. |
| Project | The board’s number (github.com/orgs/<owner>/projects/<number>) or its exact title. |
| New project title | Create Project: the new board’s title. |
| Task | Update Item and Archive Item: the task, by its ID (PVTI_…, from List Items) or its title. |
| Title / Notes | Create Item: the new task’s title and description. In Update Item, the new title or notes of a draft. |
| Issue or pull request | Create Item: the link of an existing issue or pull request, to add it to the board instead of creating a draft. |
| Field values | Fields to set, by name: Status=In progress; Priority=High; Due=2026-11-10. Options must exist on the board (List Fields gives them). |
| Filter | List Items: only tasks whose title or any field contains this text (a status, a person, a word). |
| Limit | Most boards or tasks returned (100 by default). |
Output
List Projects: each board’s number, title, link, whether it is closed and how many tasks it has.List Fields: each field of the board with its type and options (for example, theStatuscolumns).List Items: per task, its ID, whether it is a draft, issue or pull request, the title, the status and the other fields, assignees, link, repository and notes.Create Item,Update Item,Archive ItemandCreate Project: the confirmation, with the task’s ID or the board’s number and what changed.
If an option does not exist on the board, the error lists the valid ones. An archived task can be restored from the board’s archive on GitHub.
As an agent’s tool
Connect it to the tools port of an Agent or a Voice Agent with Owner and Project fixed. The AI fills the title, notes, task and fields. It helps to give it List Fields too, so it knows the board’s statuses. See Tool Mode.
Example
A voice agent that writes down the tasks in the project meeting:
- Add Projects with
Create Item, Ownermy-organd Project3, connected as a tool of the Voice Agent. - Add another Projects with
Update Itemso it can move them between statuses. - In the meeting: “write down that Pedro reviews PR 412, in progress”; the agent creates the task with
Status=In progress.
Related components
- Issue: a repository’s issues.
- Commits: what changed.
- Actions & Deployments: what was deployed.