Install GitHub Actions

Pick your client, copy the command, done.

claude mcp add -e "GITHUB_TOKEN=${GITHUB_TOKEN}" github-actions -- npx -y mcp-server-github-actions

Required:GITHUB_TOKEN

Environment Variables

Set these before running GitHub Actions.

VariableDescriptionRequired

GITHUB_TOKENGitHub Personal Access Token with Actions permissionsYes

Once configured, GitHub Actions gives your AI agent access to:

list_workflowsList all workflow files in a repository

list_runsList workflow runs (optionally filter by workflow or status)

get_runGet details of a specific workflow run

get_run_logsGet the logs URL for a run (zip file download)

rerun_workflowRe-run an entire workflow run

rerun_failed_jobsRe-run only the failed jobs from a run

cancel_runCancel an in-progress or queued run

list_artifactsList artifacts produced by a workflow run

trigger_workflowTrigger a workflow via workflow_dispatch

After setup, try these prompts with your AI agent:

→List the last 5 workflow runs for ofershap/mcp-server-docker

→Re-run the failed jobs for run 67890 in my-org/my-repo

→Cancel the currently running workflow run 11111

→Trigger the deploy.yml workflow on the staging branch for my-org/my-app

→What's the status of the most recent CI run for this project?

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Node.js 18+ with npm/npx installed
GITHUB_TOKEN — GitHub Personal Access Token with Actions permissions

Save the docs, env vars, and workflow around GitHub Actions in Conare so Claude Code, Codex, and Cursor remember it next time.