GitHub Actions MCP Server
@Since120
About GitHub Actions MCP Server
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"github-actions": {
"command": "node",
"args": [
"<path-to-mcp-server>/dist/index.js"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}Tools
19`owner` (string): Repository owner (username or organization)
List of workflows in the repository
`owner` (string): Repository owner (username or organization)
Detailed information about the workflow
`owner` (string): Repository owner (username or organization)
Usage statistics including billable minutes
`owner` (string): Repository owner (username or organization)
List of workflow runs matching the criteria
`owner` (string): Repository owner (username or organization)
Detailed information about the specific workflow run
`owner` (string): Repository owner (username or organization)
List of jobs in the workflow run
`owner` (string): Repository owner (username or organization)
Information about the triggered workflow run
`owner` (string): Repository owner (username or organization)
Status of the cancellation operation
run a workflow run
`owner` (string): Repository owner (username or organization)
Status of the re-run operation
Overview
What is GitHub Actions MCP Server?
MCP Server for the GitHub Actions API, enabling AI assistants to manage and operate GitHub Actions workflows. It is compatible with multiple AI coding assistants including Claude Desktop, Codeium, and Windsurf.
How to use GitHub Actions MCP Server?
Clone the repository, run npm install and npm run build (or build:win on Windows). Then configure the server in your AI assistant’s MCP configuration file (e.g., claude_desktop_config.json) with the GITHUB_PERSONAL_ACCESS_TOKEN environment variable set. Invoke tools such as list_workflows or trigger_workflow through the assistant.
Key features of GitHub Actions MCP Server
- Complete workflow management: list, view, trigger, cancel, rerun
- Workflow run analysis with detailed job information
- Comprehensive error handling with clear messages
- Flexible type validation for API response variations
- Security‑focused design with timeout and rate limiting
- Pagination support for listing workflows and runs
Use cases of GitHub Actions MCP Server
- Trigger a workflow on a specific branch with custom inputs
- Monitor workflow runs and their job details
- Cancel or rerun failed or stuck workflow runs
- View workflow usage statistics including billable minutes
- List workflows in a repository and inspect their configuration
FAQ from GitHub Actions MCP Server
What authentication is required?
A GitHub Personal Access Token with appropriate permissions must be provided via the GITHUB_PERSONAL_ACCESS_TOKEN environment variable.
Which AI assistants are compatible?
The server is compatible with Claude Desktop, Codeium, and Windsurf.
How do I build and run the server?
Clone the repo, then run npm install and npm run build (or build:win on Windows). On Windows you can also use the included run-server.bat batch file.
Does the server handle GitHub API rate limits?
Yes, the server implements rate limiting to avoid hitting GitHub’s API limits. If you encounter rate limit errors, reduce request frequency.
What license is this server under?
This MCP server is licensed under the MIT License.
Frequently asked questions
What authentication is required?
A GitHub Personal Access Token with appropriate permissions must be provided via the `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable.
Which AI assistants are compatible?
The server is compatible with Claude Desktop, Codeium, and Windsurf.
How do I build and run the server?
Clone the repo, then run `npm install` and `npm run build` (or `build:win` on Windows). On Windows you can also use the included `run-server.bat` batch file.
Does the server handle GitHub API rate limits?
Yes, the server implements rate limiting to avoid hitting GitHub’s API limits. If you encounter rate limit errors, reduce request frequency.
What license is this server under?
This MCP server is licensed under the MIT License.
Basic information
More Version Control MCP servers
MCP Atlassian
soopersetMCP server for Atlassian tools (Confluence, Jira)
🚀 GitLab MR MCP
kopfrechnerInteract seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease.
Github Mcp Server
githubGitHub's official MCP Server
mcp-github-trending MCP Server
hetaoBackendMCP server for getting github trending repos & developers
Bitbucket MCP
MatanYeminiBitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs
Comments