Skip to content

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 Done when 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.

FieldWhat 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>.
ProjectThe board’s number (github.com/orgs/<owner>/projects/<number>) or its exact title.
New project titleCreate Project: the new board’s title.
TaskUpdate Item and Archive Item: the task, by its ID (PVTI_…, from List Items) or its title.
Title / NotesCreate Item: the new task’s title and description. In Update Item, the new title or notes of a draft.
Issue or pull requestCreate Item: the link of an existing issue or pull request, to add it to the board instead of creating a draft.
Field valuesFields to set, by name: Status=In progress; Priority=High; Due=2026-11-10. Options must exist on the board (List Fields gives them).
FilterList Items: only tasks whose title or any field contains this text (a status, a person, a word).
LimitMost 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, the Status columns).
  • 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 Item and Create 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:

  1. Add Projects with Create Item, Owner my-org and Project 3, connected as a tool of the Voice Agent.
  2. Add another Projects with Update Item so it can move them between statuses.
  3. In the meeting: “write down that Pedro reviews PR 412, in progress”; the agent creates the task with Status=In progress.