ofershap/mcp-server-github-actions

💻 Developer Tools
0 Views
0 Installs

📇 ☁️ - GitHub Actions — view workflow runs, read logs, re-run failed jobs, and manage CI/CD.

Quick Install

One-Click IDE Configuration
claude_desktop_config.json
{
  "mcpServers": {
    "ofershap-mcp-server-github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "ofershap-mcp-server-github-actions"
      ]
    }
  }
}
Or

Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.

Documentation Overview

mcp-server-github-actions

npm version npm downloads CI TypeScript License: 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.

npx mcp-server-github-actions

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

MCP server for GitHub Actions workflows, CI/CD runs, and deployment logs

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

ToolDescription
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

Quick Start

Cursor

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

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

VS Code

Configure your MCP client to run:

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

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.

Author

Made by ofershap

LinkedIn GitHub


README built with README Builder

License

MIT © 2026 Ofer Shapira

Related MCP Servers

Moxie-Docs-MCP★ Featured

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

💻 Developer Tools2 views
3KniGHtcZ/codebeamer-mcp

📇 ☁️ 🍎 🪟 🐧 - Codebeamer ALM integration for managing work items, trackers, and projects. Provides 17 tools for reading and writing items, associations, references, comments, and risk management data via Codebeamer REST API v3.

💻 Developer Tools1 views
21st-dev/Magic-MCP

Create crafted UI components inspired by the best 21st.dev design engineers.

💻 Developer Tools0 views
a-25/ios-mcp-code-quality-server

📇 🏠 🍎 - iOS code quality analysis and test automation server. Provides comprehensive Xcode test execution, SwiftLint integration, and detailed failure analysis. Operates in both CLI and MCP server modes for direct developer usage and AI assistant integration.

💻 Developer Tools0 views

Engagement

Views
0
Installs
0
Upvotes
0

Views and upvotes are unique per visitor network (hashed IP). Installs count copy actions.

Status

Health: Not checked yet

We have not completed a health check for this listing yet.

No check timestamp yet.

Unclaimed listing (imported or pending owner verification). Claim it →
★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Claim this listing

Promote this listing

Optional paid placement. Free listings stay free forever.

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.