{
"markdown": "# mcp-server-github-actions\n\n[](https://www.npmjs.com/package/mcp-server-github-actions)\n[](https://www.npmjs.com/package/mcp-server-github-actions)\n[](https://github.com/ofershap/mcp-server-github-actions/actions/workflows/ci.yml)\n[](https://www.typescriptlang.org/)\n[](https://opensource.org/licenses/MIT)\n[](https://agent-plugins.org)\n\nManage GitHub Actions workflows from your AI assistant. List runs, read logs, re-run failed jobs, cancel builds, and trigger deployments without leaving your editor.\n\n```bash\nnpx mcp-server-github-actions\n```\n\n> Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Requires a GitHub token with Actions permissions.\n\n\n\nDemo built with remotion-readme-kit\n\n## Why\n\nGitHub'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.\n\n## Tools\n\n| Tool | Description |\n| ------------------- | ------------------------------------------------------------ |\n| `list_workflows` | List all workflow files in a repository |\n| `list_runs` | List workflow runs (optionally filter by workflow or status) |\n| `get_run` | Get details of a specific workflow run |\n| `get_run_logs` | Get the logs URL for a run (zip file download) |\n| `rerun_workflow` | Re-run an entire workflow run |\n| `rerun_failed_jobs` | Re-run only the failed jobs from a run |\n| `cancel_run` | Cancel an in-progress or queued run |\n| `list_artifacts` | List artifacts produced by a workflow run |\n| `trigger_workflow` | Trigger a workflow via `workflow_dispatch` |\n\n## Quick Start\n\n### Cursor\n\nAdd to your Cursor MCP settings (e.g. `~/.cursor/mcp.json` or project-level):\n\n```json\n{\n \"mcpServers\": {\n \"github-actions\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-server-github-actions\"],\n \"env\": {\n \"GITHUB_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"github-actions\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-server-github-actions\"],\n \"env\": {\n \"GITHUB_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n### VS Code\n\nAdd to user settings or `.vscode/mcp.json`:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"github-actions\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-server-github-actions\"],\n \"env\": {\n \"GITHUB_TOKEN\": \"\"\n }\n }\n }\n }\n}\n```\n\n## Auth\n\nCreate a GitHub Personal Access Token:\n\n1. **Settings** > **Developer settings** > **Personal access tokens**\n2. Choose **Fine-grained tokens** (recommended) or **Tokens (classic)**\n3. Fine-grained: select your repos, then enable **Actions: Read and Write**\n4. Classic: enable the `repo` scope (includes Actions)\n\n## Agent Plugins\n\nThis repo is an [Agent Plugins](https://agent-plugins.org) 1.0.0 package: `plugin.json`, portable `mcp.json`, and `skills/` ship together with the MCP server.\n\nFor Cursor, clone the repo and copy or symlink it to `~/.cursor/plugins/local/mcp-server-github-actions`, then reload the window. Skills and MCP show up under Customize > Plugins.\n\nAgent Plugins v1 does not ship OAuth. Set `GITHUB_TOKEN` in your MCP client config (see Quick Start). One-click Cursor/VS Code install is not offered because the token must stay in env.\n\n## FAQ\n\n### What is mcp-server-github-actions?\n\nAn MCP server for GitHub Actions: list runs, fetch run details, re-run failed jobs, cancel runs, list artifacts, and trigger `workflow_dispatch`.\n\n### What token do I need?\n\nA GitHub PAT with Actions read/write on the repos you manage. Set `GITHUB_TOKEN` in the MCP server env block.\n\n### How is this different from the official GitHub MCP?\n\nThe official server covers repos, issues, and PRs. This one focuses on workflow runs, logs URLs, reruns, and dispatch triggers.\n\n### Can I install it as an Agent Plugin in Cursor?\n\nYes, via `~/.cursor/plugins/local/mcp-server-github-actions`. You still configure `GITHUB_TOKEN` in Cursor MCP settings.\n\n### Why is there no one-click install button?\n\nThe token cannot be embedded safely in a portable install link. Use the JSON snippet under Quick Start.\n\n## Example Prompts\n\n- \"List the last 5 workflow runs for ofershap/mcp-server-docker\"\n- \"Show me the workflows in the microsoft/vscode repo\"\n- \"Get details for run 12345 in owner/repo\"\n- \"Re-run the failed jobs for run 67890 in my-org/my-repo\"\n- \"Cancel the currently running workflow run 11111\"\n- \"List artifacts from the latest run in owner/repo\"\n- \"Trigger the deploy.yml workflow on the staging branch for my-org/my-app\"\n- \"What's the status of the most recent CI run for this project?\"\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm run build\nnpm test\nnpm run lint\nnpm run format\n```\n\n## See also\n\nMore MCP servers and developer tools on my [portfolio](https://gitshow.dev/ofershap).\n\n## Author\n\n[](https://gitshow.dev/ofershap)\n\n[](https://linkedin.com/in/ofershap)\n[](https://github.com/ofershap)\n\n---\n\nREADME built with [README Builder](https://ofershap.github.io/readme-builder/)\n\n## License\n\nMIT © 2026 Ofer Shapira\n",
"bytes": 6588,
"sha": "3188259e5e4617a6dd32a96d71c6464a5f286e85538269cc4e9894ce16c29d02",
"repo_slug": "ofershap/mcp-server-github-actions",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_ofershap_github_actions_04961c22/readme"
}