# YAML Workflow

YAML Workflow is a Claude Code MCP server that turns declarative YAML pipelines into agent tools. Runs build steps and data workflows directly over stdio.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: orieg
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/orieg/yaml-workflow
- Updated: 2026-10-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/yaml-workflow

## What it does

YAML Workflow exposes local task pipelines to the AI model as executable functions. The engine handles various task types, including shell scripts, inline Python code, HTTP calls, Jinja2 templates, and batch operations. Execution state is tracked in local files, allowing failed runs to resume without restarting from scratch.

Workflows support parallel execution via `depends_on`, step composition with `imports`, and dry-run previews to inspect commands beforehand. Running the server requires Python and the `uvx` runner in your environment.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yaml-workflow -- uvx yaml-workflow
```
uvx runs the command named after the package; if the README names another one, use uvx --from yaml-workflow <command>

### Codex

**Platform CLI**
```bash
codex mcp add yaml-workflow -- uvx yaml-workflow
```
uvx runs the command named after the package; if the README names another one, use uvx --from yaml-workflow <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yaml-workflow": {
            "command": "uvx",
            "args": [
                "yaml-workflow"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yaml-workflow <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yaml-workflow": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "yaml-workflow"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yaml-workflow <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add yaml-workflow uvx yaml-workflow
```
uvx runs the command named after the package; if the README names another one, use uvx --from yaml-workflow <command>

## When to use it
- run multi-step build workflows directly from the model interface
- orchestrate shell tasks and Python code inside versioned YAML files
- preview workflow execution steps without modifying files using dry-run
- resume interrupted batch pipelines from the last successful step

## Example prompts
- Run the workflow at `workflows/hello_world.yaml` with parameter `name=Alice`
- Execute a dry-run preview for `workflows/data_pipeline.yaml`
- Check the execution status of the current YAML pipeline

## Similar
- [k8s-yaml-validator](https://affpapa.org/en/nevibecode/skills/k8s-yaml-validator.md) — skill · 754 installs
- [k8s-yaml-generator](https://affpapa.org/en/nevibecode/skills/k8s-yaml-generator.md) — skill · 726 installs
- [home-assistant-best-practices](https://affpapa.org/en/nevibecode/skills/home-assistant-best-practices.md) — skill · 9500 installs
- [yaml](https://affpapa.org/en/nevibecode/skills/yaml.md) — skill · 1100 installs
- [Open Source Release Checklist Builder (YAML)](https://affpapa.org/en/nevibecode/prompts/open-source-release-checklist-builder-yaml.md) — prompt · ★ 178201 repo stars
- [manifest-yaml-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/manifest-yaml-cursorrules-prompt-file.md) — rule · ★ 41178 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
