omv-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OMV_SUDO | No | 1 prefixes every command with sudo, for non-root SSH users | 0 |
| OMV_SSH_KEY | No | Path to a private key. Leave empty to use your ssh-agent and ~/.ssh/config. | |
| OMV_TIMEOUT | No | Per-command timeout in seconds | 60 |
| OMV_READONLY | No | 1 refuses anything that does not look like a read method, and disables omv_shell | 0 |
| OMV_RPC_USER | No | The OMV user the RPC call runs as | admin |
| OMV_SSH_HOST | No | Hostname or IP of the NAS. Empty means run commands locally — use that if you run this server on the NAS. | |
| OMV_SSH_PORT | No | SSH port | 22 |
| OMV_SSH_USER | No | SSH user | root |
| OMV_ALLOW_SHELL | No | 0 removes the omv_shell tool entirely | 1 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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