MCP

Manage GitHub Actions Workflows

Name: Manage GitHub Actions Workflows
Availability: OnlineOnly
Author: Koichi Okuda

MCP server that connects AI assistants to the GitHub Actions API to trigger, monitor, cancel, and rerun workflows programmatically.

Connect

Works with github

Koichi Okuda

Maintainer?

Spark score

out of 100

Updated 4 months ago

Version 1.0.0

Models

claude

Add to Favorites

Why it matters

Empower AI assistants to fully manage GitHub Actions workflows, enabling seamless triggering, monitoring, and analysis of workflow executions directly from your AI environment.

Outcomes

What it gets done

List and retrieve details of GitHub Actions workflows.

Trigger, cancel, and rerun GitHub Actions workflows.

Monitor workflow runs and analyze job execution details.

Authenticate securely using GitHub Personal Access Tokens.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-github-actions | bash

Capabilities

Tools your agent gets

list_workflows

List workflows in a GitHub repository with pagination support

get_workflow

Get details of a specific workflow by ID or file name

get_workflow_usage

Get workflow usage statistics, including billable minutes

list_workflow_runs

List all workflow runs for a repository or specific workflow with filtering

get_workflow_run

Get details of a specific workflow run

get_workflow_run_jobs

Get jobs for a specific workflow run with filtering and pagination

trigger_workflow

Trigger a workflow with optional input parameters

cancel_workflow_run

Cancel a running workflow

rerun_workflow

Rerun a workflow

Overview

GitHub Actions MCP Server

What it does

An MCP server that wraps the GitHub Actions API, providing tools to list, trigger, monitor, cancel, and rerun workflows. Supports workflow usage statistics and detailed job information retrieval.

How it connects

Use when you need AI assistants to interact with GitHub Actions workflows programmatically through the Model Context Protocol.

Source README

An MCP server for the GitHub Actions API that enables AI assistants to manage and work with GitHub Actions workflows, including triggering, monitoring, and analyzing workflow execution.

Installation

From Source (Unix/Linux/macOS)

git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
cd github-actions-mcp-server
npm install
npm run build

From Source (Windows)

git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
cd github-actions-mcp-server
npm install
npm run build:win

Batch File for Windows

run-server.bat [optional-github-token]

Configuration

Claude Desktop

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "<path-to-mcp-server>/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Codeium

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "<path-to-mcp-server>/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "github-actions": {
      "command": "node",
      "args": [
        "<path-to-mcp-server>/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Available Tools

Tool	Description
`list_workflows`	List workflows in a GitHub repository with pagination support
`get_workflow`	Get details of a specific workflow by ID or file name
`get_workflow_usage`	Get workflow usage statistics, including billable minutes
`list_workflow_runs`	List all workflow runs for a repository or specific workflow with filtering capability
`get_workflow_run`	Get details of a specific workflow run
`get_workflow_run_jobs`	Get jobs for a specific workflow run with filtering and pagination
`trigger_workflow`	Trigger a workflow with optional input parameters
`cancel_workflow_run`	Cancel a running workflow
`rerun_workflow`	Rerun a workflow

Features

Complete Workflow Management: View list, view details, trigger, cancel, and rerun workflows
Workflow Run Analysis: Get detailed information about workflow runs and their jobs
Comprehensive Error Handling: Clear error messages with extended details
Flexible Type Validation: Robust type checking with proper handling of API variations
Security-Focused Design: Timeout handling, rate limiting, and strict URL validation

Environment Variables

Required

GITHUB_PERSONAL_ACCESS_TOKEN - GitHub Personal Access Token for API authentication

Usage Examples

View the list of workflows in your repository

Trigger a workflow with specific inputs and branch reference

Monitor workflow runs and get detailed information about jobs

Cancel running workflows or rerun failed workflows

Notes

⚠️ Archival Notice: This repository will be archived soon as the official GitHub MCP server is adding Actions support. Compatible with Claude Desktop, Codeium, and Windsurf. Includes batch files and build commands specifically for Windows.

Discussion