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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

Related MCP Servers

  • Shell Exec MCP

    domdomegg
    A
    license
    Not graded
    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.
    72
    8
    MIT

  • Terminal MCP Server

    magadsm
    F
    license
    Not graded
    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.
    -

  • command-executor

    andrelip
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables shell command execution with automatic pagination for large outputs, supporting custom directories and timeouts.
    -

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