# walkerOS Flow MCP server

> Build, validate, simulate, bundle, and deploy walkerOS event pipelines directly from your local machine.

- Repository: https://github.com/elbwalker/walkerOS
- Page: https://hostedmcp.org/servers/elbwalker/flow
- Transport: stdio
- Stars: 350
- License: MIT
- Latest version: 4.5.0

## Install

### Claude Code

```sh
claude mcp add --env 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' flow -- npx -y @walkeros/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": [
        "-y",
        "@walkeros/mcp"
      ],
      "env": {
        "WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "flow": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@walkeros/mcp"
      ],
      "env": {
        "WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"flow","type":"stdio","command":"npx","args":["-y","@walkeros/mcp"],"env":{"WALKEROS_TOKEN":"<YOUR_WALKEROS_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": [
        "-y",
        "@walkeros/mcp"
      ],
      "env": {
        "WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add flow --env 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' -- npx -y @walkeros/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.flow]
command = "npx"
args = ["-y", "@walkeros/mcp"]

[mcp_servers.flow.env]
WALKEROS_TOKEN = "<YOUR_WALKEROS_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' flow npx -- -y @walkeros/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": [
        "-y",
        "@walkeros/mcp"
      ],
      "env": {
        "WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `WALKEROS_TOKEN` | no | yes | walkerOS API token. Optional, the local tools work without it and the auth tool can log in instead. |
| `WALKEROS_APP_URL` | no | no | Base URL override for the walkerOS app. Defaults to https://app.walkeros.io. |
| `WALKEROS_PROJECT_ID` | no | no | Default walkerOS project id (proj_...) used by the cloud tools. |

## FAQ

### How do I install the walkerOS MCP server?

You can install it using npm with the command npm install @walkeros/mcp.

### How do I configure the server in my MCP client?

The server runs over stdio and can be added to your client's configuration using npx @walkeros/mcp.

### What is the difference between the local and hosted server?

The local server allows you to validate, simulate, bundle, and push flows on your own machine, while the hosted server covers what the walkerOS app stores.