Workflow MCP Server

by juliusolsson05io.github.Juliusolsson05/workflow-mcpv1.1.0

Session-bound Docker workflow server through Codex. State is discarded with the container.

4Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Workflow MCP server

claude mcp add standalone -e OPENAI_API_KEY='<openai-api-key>' -- docker run -i --rm -e OPENAI_API_KEY docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855

{
  "mcpServers": {
    "standalone": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAI_API_KEY",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "standalone": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAI_API_KEY",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "standalone": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAI_API_KEY",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "standalone": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAI_API_KEY",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OPENAI_API_KEY	yes	yes	OpenAI API key used only by the contained Codex provider.
WORKFLOW_MCP_CONCURRENCY	—	—	Constrained session profile; the Docker-first daemon bundle provides the larger durable profile.

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-07-27 · 3mo ago · GitHub · v1.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-27 · 3mo ago · official registry · v1.1.0

FAQ

›How do I install the Workflow MCP server in Claude Code?

Run: claude mcp add standalone -e OPENAI_API_KEY='<openai-api-key>' -- docker run -i --rm -e OPENAI_API_KEY docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Workflow require an API key?

Yes. It expects OPENAI_API_KEY, of which 1 is a secret.

›Can I use Workflow as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Workflow in the official MCP registry?

Yes, as io.github.Juliusolsson05/workflow-mcp.