Skip to main content
Glama
peterhel

owui-bash-mcp

by peterhel
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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 installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Shell Exec MCP

    domdomegg
    A
    license
    -
    quality
    C
    maintenance
    Enables execution of bash commands with support for timeouts and background jobs, allowing file operations, build commands, system inspection, and long-running tasks.
    54
    7
    MIT

  • Terminal MCP Server

    magadsm
    F
    license
    -
    quality
    D
    maintenance
    Enables 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.

View all related MCP servers

Related MCP Connectors

  • SentinelX

    Operate your Linux servers from your LLM. Every action runs through an auditable allowlist.

  • SandboxAPI

    Execute code in 8 languages (Python, JS, TS, Go, Java, C++, C, Bash) in gVisor sandboxes.

  • Hint-Services-obsidian-github-mcp

    Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/peterhel/owui-bash-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server