list_workflow_runs

list_workflow_runs

Retrieve and filter workflow runs for a GitHub repository by owner, repo, workflow ID, actor, branch, event, status, or creation date. Supports pagination and excluding PR-triggered runs.

Instructions

List all workflow runs for a repository or specific workflow

Input Schema

Name	Required	Description
`actor`	No	Filter by user who triggered the workflow
`branch`	No	Filter by branch
`checkSuiteId`	No	Filter by check suite ID
`created`	No	Filter by creation date (YYYY-MM-DD)
`event`	No	Filter by event type
`excludePullRequests`	No	Exclude PR-triggered runs
`owner`	Yes	Repository owner
`page`	No	Page number for pagination
`perPage`	No	Results per page (max 100)
`repo`	Yes	Repository name
`status`	No	Filter by status
`workflowId`	No	The ID of the workflow or filename

Input Schema (JSON Schema)

{
  "properties": {
    "actor": {
      "description": "Filter by user who triggered the workflow",
      "type": "string"
    },
    "branch": {
      "description": "Filter by branch",
      "type": "string"
    },
    "checkSuiteId": {
      "description": "Filter by check suite ID",
      "type": "number"
    },
    "created": {
      "description": "Filter by creation date (YYYY-MM-DD)",
      "type": "string"
    },
    "event": {
      "description": "Filter by event type",
      "type": "string"
    },
    "excludePullRequests": {
      "description": "Exclude PR-triggered runs",
      "type": "boolean"
    },
    "owner": {
      "description": "Repository owner",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination",
      "type": "number"
    },
    "perPage": {
      "description": "Results per page (max 100)",
      "type": "number"
    },
    "repo": {
      "description": "Repository name",
      "type": "string"
    },
    "status": {
      "description": "Filter by status",
      "enum": [
        "completed",
        "action_required",
        "cancelled",
        "failure",
        "neutral",
        "skipped",
        "stale",
        "success",
        "timed_out",
        "in_progress",
        "queued",
        "requested",
        "waiting"
      ],
      "type": "string"
    },
    "workflowId": {
      "description": "The ID of the workflow or filename",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    }
  },
  "required": [
    "owner",
    "repo"
  ],
  "type": "object"
}

GitHub Actions MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from GitHub Actions MCP Server

Related Tools

MCP directory API