# GitHub Actions MCP server

> Manage GitHub Actions workflows by listing runs, reading logs, re-running failed jobs, and triggering deployments directly from an AI assistant.

- Repository: https://github.com/ofershap/mcp-server-github-actions
- Page: https://hostedmcp.org/servers/ofershap/mcp-server-github-actions
- Transport: stdio
- Stars: 5
- License: MIT
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add mcp-server-github-actions -- npx -y mcp-server-github-actions
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server-github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server-github-actions": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-server-github-actions","type":"stdio","command":"npx","args":["-y","mcp-server-github-actions"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-server-github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-server-github-actions -- npx -y mcp-server-github-actions
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server-github-actions]
command = "npx"
args = ["-y", "mcp-server-github-actions"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp-server-github-actions npx -- -y mcp-server-github-actions
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server-github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GITHUB_TOKEN` | no | no |  |

## Tools (9)

- `list_workflows`
- `list_runs`
- `get_run`
- `get_run_logs`
- `rerun_workflow`
- `rerun_failed_jobs`
- `cancel_run`
- `list_artifacts`
- `trigger_workflow`

## FAQ

### What is mcp-server-github-actions?

It is an MCP server that allows you to list runs, fetch run details, re-run failed jobs, cancel runs, list artifacts, and trigger workflow_dispatch.

### What token do I need to use this server?

You need a GitHub Personal Access Token (PAT) with Actions read and write permissions for the repositories you manage.

### How does this differ from the official GitHub MCP server?

While the official server handles repositories, issues, and pull requests, this server specifically focuses on workflow runs, logs, reruns, and dispatch triggers.

### Can I install this as an Agent Plugin in Cursor?

Yes, you can install it via `~/.cursor/plugins/local/mcp-server-github-actions` and must still configure your GITHUB_TOKEN in the Cursor MCP settings.