A
licenseNot graded
qualityC
maintenanceEnables execution of bash commands with support for timeouts and background jobs, allowing file operations, build commands, system inspection, and long-running tasks.
72 npm
8
MIT
owui-bash-mcp
by peterhel
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@owui-bash-mcprun ls -la in my project folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
owui-bash-mcp
Single-endpoint FastAPI OpenAPI tool server that gives Open WebUI a bash tool
for coding. Runs as the dedicated unix user owui-coder, confined to a
persistent projects workspace.
Endpoint
POST /run_bash — { command, cwd?, timeout? } → { stdout, stderr, exit_code, timed_out, truncated, cwd }.
Runs bash -lc <command> in PROJECTS_ROOT/<cwd>. Filesystem state persists
between calls; cwd does not (pass it each call).
Related MCP server: Terminal MCP Server
Config (env)
BASH_MCP_PROJECTS_ROOT(default/home/owui-coder/projects)BASH_MCP_DEFAULT_TIMEOUT(300s),BASH_MCP_MAX_TIMEOUT(1800s)BASH_MCP_MAX_OUTPUT(100000 bytes/stream, tail kept)
Run
uvicorn app:app --host 127.0.0.1 --port 8774
(8770–8773 are already taken on this host by proton-mcp / mcpo.)
Deploy
systemd system unit owui-bash-mcp.service (User=owui-coder), registered in
OWUI as tool server http://127.0.0.1:8774. See diverse/deploy.
Test
BASH_MCP_PROJECTS_ROOT=/tmp/owui-bash-test-root .venv/bin/pytest
(venv built with uv venv --python 3.13).
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo issues
Related MCP Connectors
- mcp-serverOAuthai.cdbx
Build Apps and run code in 30 languages — sandboxed, with persistent sessions for agent loops.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Develop, manage, and debug Railway projects, services, and deployments from within agents.
A persistent Linux computer for your AI: what it installs and writes survives the session.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables safe execution of terminal commands across different shells (bash, cmd, PowerShell) with configurable timeouts, working directories, and resource limits for command-line operations through AI assistants.-
- FlicenseNot gradedqualityDmaintenanceEnables shell command execution with automatic pagination for large outputs, supporting custom directories and timeouts.-
- AlicenseNot gradedqualityBmaintenanceEnables file operations and bash command execution on the local workspace, securely exposed to ChatGPT via OpenAI Tunnel.2MIT