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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "github-list-project-items",
"configured_props": {
"github": { "authProvisionId": "apn_xxxxxxx" },
"owner": "Owner",
"repo": "Repository"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "github",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "github-list-project-items",
arguments: {
owner: "Owner",
repo: "Repository",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗