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.
50 npm
9
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
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.
I run shell commands on your private cloud environment (bash, sh, zsh)
- mcp-serverOAuthai.cdbx
Build Apps and run code in 30 languages — sandboxed, with persistent sessions for agent loops.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
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