github-actions — Claude Code MCP server: CI and setup
github-actions is an MCP server for Claude Code that lists GitHub Actions runs, retrieves log links, and reruns jobs. The agent can use it to inspect CI failures and manage workflow runs.
MIT ★ 5 updated 2026-08-10
claude mcp add github-actions -- npx -y mcp-server-github-actionsWhat github-actions does
github-actions gives an assistant tools to inspect workflow files and runs, fetch details for a run, and retrieve its log link. It can rerun a complete workflow or only its failed jobs. It can also cancel queued or active runs, list artifacts, and start a workflow through workflow_dispatch.
The server needs a GitHub Personal Access Token with Actions read and write access to the repositories it manages. Set the token as GITHUB_TOKEN in the MCP client configuration. For a Fine-grained token, grant Actions: Read and Write; a classic token needs the repo scope.
What it helps with
- list workflow runs in a repository
- inspect a run and retrieve its log link
- rerun jobs that failed in a workflow run
- cancel a run or dispatch a workflow
Example prompts for the agent
- List the recent workflow runs in this repository.
- Why did the latest CI run fail?
- Rerun the failed jobs for run
12345inowner/repo.
How to install github-actions
Platform CLI
claude mcp add github-actions -- npx -y mcp-server-github-actionsPlatform CLI
codex mcp add github-actions -- npx -y mcp-server-github-actionsConfig file
{
"mcpServers": {
"github-actions": {
"command": "npx",
"args": [
"-y",
"mcp-server-github-actions"
]
}
}
}Config file
{
"servers": {
"github-actions": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-github-actions"
]
}
}
}Platform CLI
gemini mcp add github-actions npx -y mcp-server-github-actionsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about github-actions
How do I install github-actions in Claude Code?
Run claude mcp add github-actions -- npx -y mcp-server-github-actions. Configure GITHUB_TOKEN with Actions permissions for the repositories to manage.
What does github-actions do?
It lets an assistant inspect GitHub Actions runs and log links, rerun workflows or failed jobs, cancel runs, list artifacts, and dispatch workflows.
What does github-actions need to work?
It requires a GitHub Personal Access Token with Actions read and write permissions. Set it as GITHUB_TOKEN in the MCP client configuration.