GitHub Actions MCP Server

Manage GitHub Actions workflows directly from your AI assistant.

What it Does

• Workflow Management: List and inspect workflows
• Run Control: Trigger workflow runs and monitor progress
• Job Debugging: View logs and diagnose failed jobs
• Artifact Access: Download and inspect build artifacts
• Secret Management: View and update repository secrets

Installation

# Using npx
npx -y @anthropic-ai/mcp-server-github-actions

# Using Docker
docker run -i --rm -e GITHUB_TOKEN mcp/github-actions

Configuration

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Example Prompts

• "Show me the latest workflow runs for main branch"
• "Why did the CI workflow fail?"
• "Trigger the deployment workflow for staging"
• "Show logs from the test job"
• "List all workflows in this repository"

Required Permissions

• repo - Full repository access
• workflow - Update GitHub Actions workflows
• actions:read - View workflow runs and jobs