About Iobroker.mcp
Iobroker.mcp is an MCP server published by ioBroker in the Developer Tools category: mCP server for ioBroker.
The repository has 6 stars and 3 forks, with the last commit yesterday. Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add iobroker-mcp -- npx -y iobroker.mcpnpx -y iobroker.mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (47)
add_instanceCreate an instance of an adapter from the repository (`iobroker add`) — requires *Allow managing adapters*
Parameters not published.
clear_notificationsAcknowledge system notifications, optionally of one scope/category/instance — requires *Allow setting states*
Parameters not published.
create_aliasCreate an alias (`alias.0.*`) pointing to a state, optionally with a separate write state — requires *Allow object/file changes*
Parameters not published.
create_sceneCreate or update a scene for the ioBroker `scenes` adapter (state/value pairs applied together) — requires *Allow object/file changes*
Parameters not published.
create_stateCreate a new state object with type/role/unit/min/max and optional initial value — requires *Allow object/file changes*
Parameters not published.
delete_fileDelete a file from an adapter file storage — requires *Allow object/file changes*
Parameters not published.
delete_instanceDelete an instance with its objects and states (`iobroker del`) — requires *Allow managing adapters*
Parameters not published.
delete_objectDelete an object, optionally with all children — requires *Allow object/file changes*
Parameters not published.
delete_scriptDelete a script — requires *Allow changing scripts*
Parameters not published.
enable_scriptStart or stop a script — requires *Allow changing scripts*
Parameters not published.
Show all 47 tools
file_existsCheck whether a file exists in an adapter file storage
Parameters not published.
get_logsRetrieve recent ioBroker log lines; optional filters by `level` (error/warn/info/debug), source `adapter` and start time (`from_ts`)
Parameters not published.
get_objectRead a single object by its ID
Parameters not published.
get_scriptRead a script including its source
Parameters not published.
get_statesRetrieve the current value of one or multiple states; IDs may contain wildcards (e.g. `hue.0.*.brightness`)
Parameters not published.
history_queryQuery historical values (requires a history adapter); aggregations: `raw`, `min`, `max`, `avg`, `sum`, `count`, `minmax`, `percentile`, `quantile`, `integral`
Parameters not published.
install_packageInstall an adapter package (npm, GitHub, URL, `.tgz` from the file storage or as base64) on a host and restart its enabled instances — requires *Allow installing packages*, developers only
Parameters not published.
list_adapter_updatesList installed adapters that have a newer version in the active repository
Parameters not published.
list_adaptersList installed adapters with metadata (version, title, description, keywords)
Parameters not published.
list_devicesList detected devices grouped by room (uses the ioBroker type-detector to expose functional devices with named controls); optional `language` and `room` filter
Parameters not published.
list_filesList a directory in an adapter file storage
Parameters not published.
list_functionsList functions (`enum.functions.*`) with localized names and member details; optional `language` and `withIcons`
Parameters not published.
list_hostsList ioBroker hosts with their status
Parameters not published.
list_instancesList adapter instances with their status
Parameters not published.
list_notificationsList the system notifications of the hosts (the bell in admin): disk space, crashed adapters, ...
Parameters not published.
list_roomsList rooms (`enum.rooms.*`) with localized names and member details; optional `language` and `withIcons`
Parameters not published.
list_scriptsList the scripts of the javascript adapter (without source)
Parameters not published.
mkdirCreate a directory in an adapter file storage — requires *Allow object/file changes*
Parameters not published.
ping_hostDiagnose connectivity to a network device: ICMP ping to `host` plus an optional TCP connect to `port` — useful to investigate adapter `ETIMEDOUT`/connection errors
Parameters not published.
read_fileRead a file from an adapter file storage (optional base64)
Parameters not published.
rename_fileRename/move a file within the same adapter file storage — requires *Allow object/file changes*
Parameters not published.
restart_instanceRestart a running instance — requires *Allow controlling instances*
Parameters not published.
run_scriptRun code once in the javascript adapter and return its log output (javascript ≥ 10.1.0) — requires *Allow changing scripts*
Parameters not published.
search_adapter_repositorySearch the ioBroker adapter **repository** (all *installable* adapters, not just installed ones) by keyword; optional `type` category, `onlyNotInstalled` and `language` filters — use it to recommend which adapter to install for a device/service
Parameters not published.
search_objectsSearch objects/states by keyword (matched against ID and name); optional filters for object `type`, `role`, `room` and source `adapter` instance
Parameters not published.
send_toSend a message to an adapter instance (`sendTo`) and return the answer — only instances in *Allow messages to adapters*
Parameters not published.
set_log_levelChange the log level of an instance, temporarily or persistently — requires *Allow controlling instances*
Parameters not published.
set_objectCreate/update an object (merges common/native) — requires *Allow object/file changes*
Parameters not published.
set_scriptCreate a JavaScript/TypeScript script or change its source — requires *Allow changing scripts*
Parameters not published.
set_stateSet the value of a state (value coerced to the state type) — requires *Allow setting states*
Parameters not published.
set_statesSet multiple states in one call (for scenes/group actions like "all lights off") — requires *Allow setting states*
Parameters not published.
start_instanceStart (enable) an instance — requires *Allow controlling instances*
Parameters not published.
stop_instanceStop (disable) an instance — requires *Allow controlling instances*
Parameters not published.
system_infoGet system and js-controller information
Parameters not published.
upgrade_adapterUpgrade an adapter to the repository or a given version (`iobroker upgrade`) — requires *Allow managing adapters*
Parameters not published.
write_fileWrite a file to an adapter file storage — requires *Allow object/file changes*
Parameters not published.
write_logWrite a message to the ioBroker log
Parameters not published.
Ask AI
Ask AI about Iobroker.mcp
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.