Build, validate, simulate, bundle, and deploy walkerOS event pipelines directly from your local machine.
Also known as elbwalker/walkerOS, flow, @walkeros/mcp
- Stars
- 350
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 4.5.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is walkerOS Flow MCP?
walkerOS Flow is an MCP server. Build, validate, simulate, bundle, and deploy walkerOS event pipelines directly from your local machine.
Summary generated from the project's README
About walkerOS Flow MCP server
Managing walkerOS event pipelines from your local development environment is possible with this MCP server. It allows developers to build, validate, simulate, bundle, and deploy flows directly from their own machines using a stdio connection. By adding the server to your MCP client configuration via npx, you can interact with your local workflows without needing to switch to a web interface.
This local implementation focuses on the lifecycle of event pipelines, providing tools to test and push flows. While a hosted version exists to cover data stored in the walkerOS app, this specific server is designed for local execution. It integrates into your existing AI client setup to streamline the process of moving from initial pipeline construction to final deployment.
What you can do with it
- 1Validate event pipeline logicAsk your AI client to check if a newly created walkerOS flow is valid before deployment.
- 2Simulate pipeline behaviorRequest a simulation of a specific event pipeline to see how it handles data.
Written from the project's README. Every use case is checked against a quote from it.
How to install walkerOS Flow MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall walkerOS Flow MCP in Claude Code
$ claude mcp add --env 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' flow -- npx -y @walkeros/mcpInstall walkerOS Flow MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"flow": {
"command": "npx",
"args": [
"-y",
"@walkeros/mcp"
],
"env": {
"WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
}
}
}
}Install walkerOS Flow MCP in VS Code
.vscode/mcp.json
{
"servers": {
"flow": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@walkeros/mcp"
],
"env": {
"WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
}
}
}
}Install walkerOS Flow MCP in VS Code CLI
$ code --add-mcp '{"name":"flow","type":"stdio","command":"npx","args":["-y","@walkeros/mcp"],"env":{"WALKEROS_TOKEN":"<YOUR_WALKEROS_TOKEN>"}}'Install walkerOS Flow MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"flow": {
"command": "npx",
"args": [
"-y",
"@walkeros/mcp"
],
"env": {
"WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
}
}
}
}Install walkerOS Flow MCP in Codex
$ codex mcp add flow --env 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' -- npx -y @walkeros/mcpInstall walkerOS Flow MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.flow] command = "npx" args = ["-y", "@walkeros/mcp"] [mcp_servers.flow.env] WALKEROS_TOKEN = "<YOUR_WALKEROS_TOKEN>"
Install walkerOS Flow MCP in Gemini CLI
$ gemini mcp add -s user -e 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' flow npx -- -y @walkeros/mcpInstall walkerOS Flow MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"flow": {
"command": "npx",
"args": [
"-y",
"@walkeros/mcp"
],
"env": {
"WALKEROS_TOKEN": "<YOUR_WALKEROS_TOKEN>"
}
}
}
}Configuration
WALKEROS_TOKENSecretwalkerOS API token. Optional, the local tools work without it and the auth tool can log in instead.
WALKEROS_APP_URLBase URL override for the walkerOS app. Defaults to https://app.walkeros.io.
WALKEROS_PROJECT_IDDefault walkerOS project id (proj_...) used by the cloud tools.
| Name | Description | |
|---|---|---|
| WALKEROS_TOKEN | walkerOS API token. Optional, the local tools work without it and the auth tool can log in instead. | Secret |
| WALKEROS_APP_URL | Base URL override for the walkerOS app. Defaults to https://app.walkeros.io. | |
| WALKEROS_PROJECT_ID | Default walkerOS project id (proj_...) used by the cloud tools. |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub@walkeros/mcp
The local walkerOS MCP server: validate, simulate, bundle and push flows on your own machine; the hosted server at https://app.walkeros.io/api/mcp covers what the walkerOS app stores.
Documentation • NPM Package • Source Code
Installation
npm install @walkeros/mcp
Quick start
The server runs over stdio and is started by your MCP client. Add it to the client's configuration:
{
"mcpServers": {
"walkeros-flow": {
"command": "npx",
"args": ["@walkeros/mcp"]
}
}
}
Documentation
Tools, resources, prompts, programmatic usage and the hosted server live in the docs: https://www.walkeros.io/docs/apps/mcp
Contribute
Feel free to contribute by submitting an issue, starting a discussion, or getting in contact.
License
MIT
walkerOS Flow MCP questions
How do I add walkerOS Flow MCP to Claude Code?
Run claude mcp add --env 'WALKEROS_TOKEN=<YOUR_WALKEROS_TOKEN>' flow -- npx -y @walkeros/mcp in your terminal. Add --scope user to make it available in every project.
How do I add walkerOS Flow MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
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.