workflows-mcp-server

Name: workflows-mcp-server
Author: cyanheads

cyanheads

Get started Repository

Store, query, and create YAML workflow playbooks for LLM agents via MCP. STDIO or Streamable HTTP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add workflows --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env WORKFLOWS_DIR='<WORKFLOWS_DIR>' -- npx -y @cyanheads/workflows-mcp-server

~/.codex/config.toml

[mcp_servers.workflows]
command = "npx"
args = ["-y", "@cyanheads/workflows-mcp-server"]
env = { MCP_TRANSPORT_TYPE = "<MCP_TRANSPORT_TYPE>", WORKFLOWS_DIR = "<WORKFLOWS_DIR>" }

# codex mcp add workflows --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env WORKFLOWS_DIR='<WORKFLOWS_DIR>' -- npx -y @cyanheads/workflows-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "workflows": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "WORKFLOWS_DIR": "<WORKFLOWS_DIR>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "workflows": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "WORKFLOWS_DIR": "<WORKFLOWS_DIR>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "workflows": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "WORKFLOWS_DIR": "<WORKFLOWS_DIR>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "workflows": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "WORKFLOWS_DIR": "<WORKFLOWS_DIR>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "workflows": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/workflows-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "WORKFLOWS_DIR": "<WORKFLOWS_DIR>"
      }
    }
  }
}

Environment variables

MCP_TRANSPORT_TYPE
WORKFLOWS_DIR

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related