# Mcp Server Github Actions

> MCP server for GitHub Actions — view runs, read logs, re-run jobs, trigger workflows

- **Type:** MCP server
- **Install:** `agentstack add mcp-ofershap-mcp-server-github-actions`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ofershap](https://agentstack.voostack.com/s/ofershap)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ofershap](https://github.com/ofershap)
- **Source:** https://github.com/ofershap/mcp-server-github-actions

## Install

```sh
agentstack add mcp-ofershap-mcp-server-github-actions
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-server-github-actions

[](https://www.npmjs.com/package/mcp-server-github-actions)
[](https://www.npmjs.com/package/mcp-server-github-actions)
[](https://github.com/ofershap/mcp-server-github-actions/actions/workflows/ci.yml)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)

Manage GitHub Actions workflows from your AI assistant. List runs, read logs, re-run failed jobs, cancel builds, and trigger deployments without leaving your editor.

```bash
npx mcp-server-github-actions
```

> Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Requires a GitHub token with Actions permissions.

Demo built with remotion-readme-kit

## Why

GitHub's official MCP server covers repos, issues, and PRs, but it doesn't touch Actions. That means when your CI fails, you still have to open a browser, find the run, click through to the logs, and figure out what went wrong. This server fills that gap. You can ask your assistant "why did the last CI run fail?" or "re-run the failed jobs" and get answers right where you're working. It uses the same GitHub REST API you'd use manually, just without the context switching.

## Tools

| Tool                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `list_workflows`    | List all workflow files in a repository                      |
| `list_runs`         | List workflow runs (optionally filter by workflow or status) |
| `get_run`           | Get details of a specific workflow run                       |
| `get_run_logs`      | Get the logs URL for a run (zip file download)               |
| `rerun_workflow`    | Re-run an entire workflow run                                |
| `rerun_failed_jobs` | Re-run only the failed jobs from a run                       |
| `cancel_run`        | Cancel an in-progress or queued run                          |
| `list_artifacts`    | List artifacts produced by a workflow run                    |
| `trigger_workflow`  | Trigger a workflow via `workflow_dispatch`                   |

## Quick Start

### Cursor

Add to your Cursor MCP settings (e.g. `~/.cursor/mcp.json` or project-level):

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

### Claude Desktop

Add to `claude_desktop_config.json`:

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

### VS Code

Configure your MCP client to run:

```bash
npx mcp-server-github-actions
```

Make sure `GITHUB_TOKEN` is set in the environment (e.g. in your shell profile or client config).

## Auth

Create a GitHub Personal Access Token:

1. **Settings** > **Developer settings** > **Personal access tokens**
2. Choose **Fine-grained tokens** (recommended) or **Tokens (classic)**
3. Fine-grained: select your repos, then enable **Actions: Read and Write**
4. Classic: enable the `repo` scope (includes Actions)

## Example Prompts

- "List the last 5 workflow runs for ofershap/mcp-server-docker"
- "Show me the workflows in the microsoft/vscode repo"
- "Get details for run 12345 in owner/repo"
- "Re-run the failed jobs for run 67890 in my-org/my-repo"
- "Cancel the currently running workflow run 11111"
- "List artifacts from the latest run in owner/repo"
- "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?"

## Development

```bash
npm install
npm run typecheck
npm run build
npm test
npm run lint
npm run format
```

## See also

More MCP servers and developer tools on my [portfolio](https://gitshow.dev/ofershap).

## Author

[](https://gitshow.dev/ofershap)

[](https://linkedin.com/in/ofershap)
[](https://github.com/ofershap)

---

README built with [README Builder](https://ofershap.github.io/readme-builder/)

## License

MIT © 2026 Ofer Shapira

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ofershap](https://github.com/ofershap)
- **Source:** [ofershap/mcp-server-github-actions](https://github.com/ofershap/mcp-server-github-actions)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ofershap-mcp-server-github-actions
- Seller: https://agentstack.voostack.com/s/ofershap
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.