View as Markdown
GitHub icon

GitHub ACTION

List Projects

List the Projects (V2) owned by an organization, or scoped to a specific repository (returns each project's number and title). This is the entry point for the Projects (V2) discovery chain: use the returned project number with List Project Statuses, List Project Items, or Update Project (V2) Item Status. Discover organization logins with List Organizations. Note: user-owned Projects are not supported. Returns { projects, nextCursor }; when nextCursor is non-null there are more results — pass it back as Cursor to fetch the next page. Do NOT call this with a guessed or assumed Owner: if the user hasn't named the organization/owner, ask them first rather than trying multiple organizations. 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 Projects 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-projects",
  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 Projects 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
maxResults Max Results integer
The maximum number of results to return. Defaults to 100.
Optional
cursor Cursor string
Pagination cursor to fetch the next page of results. Omit for the first page; to get more, pass the nextCursor value returned by a previous call.
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-projects
Version
0.0.3
App
GitHub
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes