run_command
Executes shell commands on the device only after enabling MCP exec/write and in-app approval; use for terminal tasks, expecting approval delays or denial.
Instructions
Runs a shell command on the device. Disabled unless the user turned on Settings → Agents → "MCP: Allow exec/write", and every call still blocks on an in-app approval tap on the phone — expect this to be slow or to fail with "denied" if nobody is there to approve it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"command": "<command>"
},
"name": "run_command"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory (optional — one of list_repos or the home dir) | |
| command | Yes | Shell command to run | |
| timeoutMs | No | Execution timeout in ms (default 30000) |