View as Markdown
GitHub icon

GitHub ACTION

List Project Items

List the items in a Project (V2). Each item has an id, a type, and its title under fieldValueByName.text (not a flat title field). Use the returned item id with Update Project (V2) Item Status to change an item's status. Get the project number from List Projects and its valid statuses from List Project Statuses. Discover organization logins with List Organizations. Returns at most 100 items with no pagination — a project with more than 100 items exposes only the last 100 (the tail of the item connection, in the connection's own order), so earlier items can't be retrieved. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's GitHub account once, then configure and run List Project Items from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "github-list-project-items",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    github: { authProvisionId: "apn_xxxxxxx" },
    owner: "Owner",
    repo: "Repository",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Project Items inputs
Property Type Description
owner Owner string
The account that owns the Project (V2) — an organization login (e.g. my-org), or a repository owner when Repository is also set. Required, and it must come from the user. If the user has not said which owner/organization the project belongs to, ask them — do NOT guess an owner or enumerate organizations to find one. If they named an organization but you need its exact login, use List Organizations. User-owned Projects are not supported.
Required
repo Repository string
Optional. The repository name without the owner (e.g. my-repo, not my-org/my-repo) when the Project (V2) is repository-scoped. Leave blank to target an organization-owned Project.
Optional
project Project Number integer
The Project (V2) number as shown in the project URL and UI (e.g. 5 in /orgs/my-org/projects/5) — not the node ID. Required. If the user has not provided it, ask them — do NOT guess. Once you know the owner, you can look up numbers with List Projects.
Required
maxResults Max Results integer
The maximum number of items to return. GitHub caps this at 100 per request. Defaults: 100
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
github-list-project-items
Version
0.0.2
App
GitHub
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes