Skip to main content
Glama
mbgroen
by mbgroen

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OMV_SUDONo1 prefixes every command with sudo, for non-root SSH users0
OMV_SSH_KEYNoPath to a private key. Leave empty to use your ssh-agent and ~/.ssh/config.
OMV_TIMEOUTNoPer-command timeout in seconds60
OMV_READONLYNo1 refuses anything that does not look like a read method, and disables omv_shell0
OMV_RPC_USERNoThe OMV user the RPC call runs asadmin
OMV_SSH_HOSTNoHostname or IP of the NAS. Empty means run commands locally — use that if you run this server on the NAS.
OMV_SSH_PORTNoSSH port22
OMV_SSH_USERNoSSH userroot
OMV_ALLOW_SHELLNo0 removes the omv_shell tool entirely1

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
omv_callA

Call an OpenMediaVault RPC method. This is the main tool.

Anything the web interface can do is available here. Some heavier methods run in the background and return {"filename": "..."} -- pass that value to omv_wait_for_task to collect the output.

Examples: omv_call("System", "getInformation") omv_call("FileSystemMgmt", "enumerateMountedFilesystems", {"includeRoot": True}) omv_call("ShareMgmt", "enumerateSharedFolders")

omv_connection_infoA

Show how this server connects and whether that works.

Useful as a first smoke test and when troubleshooting connectivity.

omv_list_methodsA

List every method of an RPC service.

Call this before omv_call so you use the exact method name instead of guessing it.

omv_list_servicesA

List every available OpenMediaVault RPC service.

This is the starting point: every action in the web interface belongs to one of these services (for example System, FileSystemMgmt, ShareMgmt, UserMgmt, Smart, Services). Installed plugins add their own services here.

Note that some service names are lowercase (for example "kernel" and "omvextras") and omv-rpc is case sensitive, so use the name exactly as returned.

omv_shellA

Run an arbitrary shell command on the NAS.

Intended for everything outside the RPC layer: reading logs (journalctl), package status, docker commands, disk details and so on.

Prefer omv_call for anything OMV manages itself, so that OMV's own configuration database stays in sync with the system.

omv_wait_for_taskA

Collect the output of a background task started by omv_call.

When omv_call returns something like {"filename": "..."}, the job is running asynchronously on the NAS. This tool polls until it finishes.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/mbgroen/omv-mcp'

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