# github-actions

github-actions is an MCP server for Claude Code that lists GitHub Actions runs, retrieves log links, and reruns jobs. The agent can use it to inspect CI failures and manage workflow runs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: ofershap
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ofershap/mcp-server-github-actions
- Updated: 2026-08-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/github-actions

## What it does

github-actions gives an assistant tools to inspect workflow files and runs, fetch details for a run, and retrieve its log link. It can rerun a complete workflow or only its failed jobs. It can also cancel queued or active runs, list artifacts, and start a workflow through `workflow_dispatch`.

The server needs a GitHub Personal Access Token with Actions read and write access to the repositories it manages. Set the token as `GITHUB_TOKEN` in the MCP client configuration. For a Fine-grained token, grant Actions: Read and Write; a classic token needs the `repo` scope.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add github-actions -- npx -y mcp-server-github-actions
```

### Codex

**Platform CLI**
```bash
codex mcp add github-actions -- npx -y mcp-server-github-actions
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "github-actions": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-github-actions"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "github-actions": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-server-github-actions"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add github-actions npx -y mcp-server-github-actions
```

## When to use it
- list workflow runs in a repository
- inspect a run and retrieve its log link
- rerun jobs that failed in a workflow run
- cancel a run or dispatch a workflow

## Example prompts
- List the recent workflow runs in this repository.
- Why did the latest CI run fail?
- Rerun the failed jobs for run `12345` in `owner/repo`.

## Similar
- [github-actions-expert](https://affpapa.org/en/nevibecode/agents/0xfurai-github-actions-expert.md) — subagent · ★ 1029 repo stars
- [github-actions-hardening](https://affpapa.org/en/nevibecode/skills/github-actions-hardening.md) — skill · 2200 installs
- [github-actions-efficiency](https://affpapa.org/en/nevibecode/skills/github-actions-efficiency.md) — skill · 2000 installs
- [crontap-replace-github-actions-cron](https://affpapa.org/en/nevibecode/skills/crontap-replace-github-actions-cron.md) — skill · 1300 installs
- [github-actions-validator](https://affpapa.org/en/nevibecode/skills/github-actions-validator.md) — skill · 722 installs
- [github-actions-generator](https://affpapa.org/en/nevibecode/skills/github-actions-generator.md) — skill · 714 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
