---
title: "GitHub Actions MCP Server Setup Guide and Schema"
slug: "github-actions"
category: "dev-tools"
package: "mcp-server-github-actions"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/github-actions"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# GitHub Actions MCP Server

> Trigger, monitor, and manage GitHub Actions CI/CD workflows.

## Overview
Automate CI/CD workflows from AI agents. Trigger workflow runs, monitor build status, view logs, manage secrets, and integrate with GitHub Actions for continuous deployment and testing.

## Quick Install
```bash
npx -y mcp-server-github-actions
```

## Environment Variables

| Variable | Description | Required |
| :--- | :--- | :--- |
| `GITHUB_TOKEN` | GitHub token with actions scope | **Yes** |

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ],
      "env": {
        "GITHUB_TOKEN": ""
      }
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-github-actions"
      ],
      "env": {
        "GITHUB_TOKEN": ""
      }
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.github-actions]
command = "npx"
args = ["-y", "mcp-server-github-actions"]

[mcp_servers.github-actions.env]
GITHUB_TOKEN = ""
```

## Available Tools (4)

- `trigger_workflow`
- `list_runs`
- `get_run_logs`
- `cancel_run`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/github-actions
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/ofershap/mcp-server-github-actions
- Setup Tutorial Guide: https://mcp-codex.com/articles/github-actions-mcp