Integration

GitHub Actions integration

GitHub Actions REST API for managing CI/CD workflows, runs, jobs, artifacts, and secrets. Trigger workflows, monitor run status, download artifacts, manage repository secrets, and control self-hosted runners.

Connect GitHub Actions How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in GitHub Actions.Built from the 59 GitHub Actions tools below, on the connection you add once.

Common GitHub Actions use cases

freeing storage
rotating credentials
automate workflow management
automate workflow run management
capacity planning
cleanup automation
setting API keys
security auditing
custom CI/CD gates
compliance auditing

What you can do with GitHub Actions

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Workflow run, 9 operations

approve_workflow_runApprove workflow runPOSTApprove a workflow run that requires approval (e.g., from first-time contributors)
cancel_workflow_runCancel workflow runPOSTCancels an in-progress workflow run. Sends a cancellation signal to all running jobs.
delete_workflow_runDelete workflow runDELETEDeletes a specific workflow run by ID. Removes the run, its logs, and associated check suites.
force_cancel_workflow_runForce cancel workflow runPOSTForce-cancels a workflow run, bypassing conditions that would normally prevent cancellation (e.g., concurrency groups, post-job tasks).
get_workflow_runGet workflow runGETGets detailed information about a specific workflow run including status, conclusion, timing, and triggering commit.
get_workflow_run_attemptGet workflow run attemptGETGets a specific attempt of a workflow run including its status, conclusion, and timing for that attempt only.
list_workflow_runsList workflow runsGETLists all workflow runs for a repository with optional filters for status, branch, and trigger event.
list_workflow_runs_for_workflowList workflow runs for workflowGETList all runs for a specific workflow with optional status and branch filters
rerun_workflowRerun workflowPOSTRe-runs a completed workflow run. Creates a new run attempt using the same commit and workflow configuration.

Runner, 6 operations

create_runner_registration_tokenCreate runner registration tokenPOSTReturns a token (valid 1 hour) that the runner config script uses to register a new self-hosted runner with the repository.
create_runner_remove_tokenCreate runner remove tokenPOSTReturns a token (valid 1 hour) used by the runner uninstall script to deregister a runner from the repository.
delete_self_hosted_runnerDelete self hosted runnerDELETEForces removal of a self-hosted runner from the repository. Runner will appear offline immediately.
get_self_hosted_runnerGet self hosted runnerGETGets details for a specific self-hosted runner: id, name, os, status, busy flag, and labels.
list_runner_application_downloadsList runner application downloadsGETLists download URLs for self-hosted runner binaries across supported OS and architectures.
list_self_hosted_runnersList self hosted runnersGETLists all self-hosted runners registered for a repository including their status, OS, and labels.

Secret, 5 operations

create_or_update_repo_secretCreate or update repo secretPUTCreates or updates a repository secret. The value must be encrypted with the repository's public key before sending.
delete_repo_secretDelete repo secretDELETEDeletes a repository secret by name. Workflows can no longer access this secret after deletion.
get_repo_public_keyGet repo public keyGETGets the repository's public key for encrypting secrets before creating or updating them via the API.
get_repo_secretGet repo secretGETGets metadata for a specific repository secret. Returns name and timestamps but never the secret value.
list_repo_secretsList repo secretsGETLists all secrets available to GitHub Actions workflows in a repository. Returns secret names and creation dates (not values).

Workflow, 5 operations

create_workflow_dispatchCreate workflow dispatchPOSTTriggers a workflow_dispatch event to manually start a workflow run. Requires the workflow to have a workflow_dispatch trigger configured.
disable_workflowDisable workflowPUTDisable a workflow, preventing future runs from being triggered
enable_workflowEnable workflowPUTEnable a workflow that was previously disabled
get_workflowGet workflowGETGets a specific workflow definition by its numeric ID or filename. Returns workflow metadata including state, path, and badge URL.
list_workflowsList workflowsGETLists all workflows configured in a repository. Returns workflow id, name, path, state, and URLs for each workflow definition file.

Actions cache, 4 operations

delete_actions_cache_by_idDelete actions cache by idDELETEDeletes a single GitHub Actions cache by its numeric ID.
delete_actions_cache_by_keyDelete actions cache by keyDELETEDeletes one or more caches matching the supplied key (and optionally ref).
get_actions_cache_usageGet actions cache usageGETReturns total cache storage used by the repository and the count of full cache entries.
list_actions_cachesList actions cachesGETLists all GitHub Actions caches for a repository with filtering by ref, key, and sorting options.

Artifact, 4 operations

delete_artifactDelete artifactDELETEDeletes a workflow artifact by ID. Permanently removes the artifact and its associated storage.
download_artifactDownload artifactGETDownloads an artifact archive as a zip file. Returns a 302 redirect to a temporary download URL.
get_artifactGet artifactGETGets metadata for a specific artifact by ID including name, size, expiration, and download URL.
list_run_artifactsList run artifactsGETLists all artifacts produced by a workflow run. Returns artifact names, sizes, and download URLs.

Job, 4 operations

download_job_logsDownload job logsGETDownloads the raw log file for a workflow job. Returns a 302 redirect to a temporary URL for the log content.
get_jobGet jobGETGets detailed information about a specific job including all steps, timing, and runner details.
list_workflow_run_jobsList workflow run jobsGETLists all jobs within a specific workflow run. Returns job names, status, conclusion, and step details.
rerun_jobRerun jobPOSTRe-runs a specific job and any jobs that depend on it. Other jobs in the run are unaffected.

Variable, 4 operations

create_repo_variableCreate repo variablePOSTCreates a new repository variable for GitHub Actions. Variables store non-sensitive configuration accessible in workflows.
delete_repo_variableDelete repo variableDELETEDeletes a repository variable by name. Workflows referencing this variable will receive an empty value.
list_repo_variablesList repo variablesGETLists all repository-level variables available to GitHub Actions workflows. Unlike secrets, variable values are returned.
update_repo_variableUpdate repo variablePATCHUpdates the value of an existing repository variable.

Workflow run log, 3 operations

delete_workflow_run_logsDelete workflow run logsDELETEPermanently deletes all logs for a workflow run. Useful for removing logs containing sensitive data before they reach retention expiry.
download_workflow_run_logsDownload workflow run logsGETDownload the logs archive (ZIP) for a workflow run
list_workflow_run_attempts_logsList workflow run attempts logsGETDownloads the logs archive (ZIP) for a specific attempt of a workflow run. Returns 302 redirect to a short-lived URL.

Actions permissions, 2 operations

get_actions_permissionsGet actions permissionsGETReturns whether GitHub Actions is enabled for the repository and which actions/workflows are allowed.
set_actions_permissionsSet actions permissionsPUTEnables or disables GitHub Actions for the repository and configures which actions are permitted.

Deployment, 2 operations

list_pending_deploymentsList pending deploymentsGETLists all deployment environments awaiting approval (required-reviewer or wait-timer protection rules) for a workflow run.
review_pending_deploymentsReview pending deploymentsPOSTApproves or rejects pending deployments waiting on protection rules. Used by required reviewers to gate production releases.

Oidc, 2 operations

get_oidc_subject_claim_templateGet oidc subject claim templateGETReturns the customization template used when generating the OIDC subject claim (sub) for the repository's workflows.
set_oidc_subject_claim_templateSet oidc subject claim templatePUTCustomizes the OIDC subject claim template used in tokens issued to workflows in this repository, enabling fine-grained trust with cloud providers.

Workflow permissions, 2 operations

get_default_workflow_permissionsGet default workflow permissionsGETReturns the default GITHUB_TOKEN permissions (read or write) and whether Actions can approve pull requests.
set_default_workflow_permissionsSet default workflow permissionsPUTSets the default GITHUB_TOKEN scope (read or write) and whether Actions can approve pull request reviews.

Deployment protection rule, 1 operation

review_custom_deployment_protection_ruleReview custom deployment protection rulePOSTSubmits a review for a custom deployment protection rule. Called by GitHub Apps that implement custom approval gates.

Environment secret, 1 operation

list_environment_secretsList environment secretsGETList all secrets configured for a deployment environment

Org secret, 1 operation

list_org_secretsList org secretsGETList all GitHub Actions secrets configured at the organization level

Rerun failed job, 1 operation

rerun_failed_jobsRerun failed jobsPOSTRe-run only the failed jobs of a workflow run

Runner label, 1 operation

list_runner_labelsList runner labelsGETLists all labels (read-only and custom) attached to a self-hosted runner. Labels are used to target jobs via runs-on.

Workflow run approval, 1 operation

list_workflow_run_approvalsList workflow run approvalsGETReturns the audit trail of approvals and rejections for a workflow run, including reviewer, environment, state, and comment.

Workflow run usage, 1 operation

get_workflow_run_usageGet workflow run usageGETGet billable execution time and timing details for a workflow run

Use GitHub Actions from Claude Code, Cursor or Codex

Connect GitHub Actions in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its GitHub Actions operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect GitHub Actions

Create your workspace
Sign up free. Nothing to install.
Connect GitHub Actions once
Add your GitHub Actions connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

GitHub Actions integration FAQ

What can you do with the GitHub Actions integration?

LiveContext exposes 59 operations on GitHub Actions, covering workflow run, runner, secret and workflow. Common uses include freeing storage, rotating credentials and automate workflow management.