GitHub Actions MCP Server

The GitHub Actions MCP server lets Claude and other MCP-compatible agents interact with your GitHub Actions CI/CD pipelines. You can trigger workflow runs, query run history, fetch job logs, and cancel stuck runs — all from a natural-language prompt.

This is particularly useful for agentic coding workflows: after Claude edits your code, it can push a commit and immediately watch the Actions run to verify tests pass.

Prerequisites

• Node.js 18+ — required to run the server via npx
• GitHub Personal Access Token — needs repo and workflow scopes
• Generate a token at: github.com/settings/tokens/new

Installation & Configuration

Add this block to your claude_desktop_config.json:

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_yourTokenHere"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

Available Tools (5)

• list_workflows
  List workflows in a repo
• list_workflow_runs
  Get recent run history
• get_workflow_run
  Fetch run details & status
• create_workflow_dispatch
  Trigger a workflow run
• cancel_workflow_run
  Cancel an in-progress run

Use Cases

• Ask Claude "did the tests pass on the last push?" — it calls list_workflow_runs and summarises
• Trigger a deployment workflow after code review: "deploy to staging"
• Diagnose failing pipelines: Claude fetches job logs and explains the error

Tips & Gotchas

Source & Documentation