ioBroker MCP Server Logo

ioBroker MCP Server

Official

Provides a configurable web server foundation for ioBroker home automation systems to implement Mode...

8 views
0 installs
Updated Jan 19, 2026
Not audited
Provides a configurable web server foundation for ioBroker home automation systems to implement Model Context Protocol functionality. Features HTTP/HTTPS support, authentication, and basic REST API endpoints for adapter integration.
  1. Note: no ENV variables are required

    • The ioBroker.mcp adapter is configured via the ioBroker admin JSONConfig, not via environment variables. You do not need to obtain API keys or tokens for this adapter. Instead you will fill the connection values into the FastMCP connection interface when you click the "Install Now" button.
  2. Open your ioBroker Admin panel

    • Open the ioBroker admin UI on your ioBroker host (for example: http://<IOBROKER_HOST>:8081).
  3. Install the adapter (if not already installed)

    • Either run npm install iobroker.mcp on the ioBroker host or install the adapter from the ioBroker Admin → Adapters view.
  4. Open the ioBroker.mcp adapter configuration

    • In ioBroker Admin go to Adapters → search for "mcp" → open the ioBroker.mcp adapter configuration panel.
  5. Collect the connection values you will enter into FastMCP

    • Server host: the hostname or IP of your ioBroker instance (e.g., 192.0.2.10 or my-iobroker.example.com).
    • Port: set or confirm the adapter port (default: 8093). Copy this value for FastMCP.
    • Bind address: if the adapter is bound to a specific interface, note that address (default 0.0.0.0).
    • Authentication: if you enable Basic Authentication, set a Username and Password in the adapter config — these are the credentials you will enter in FastMCP.
    • HTTPS / TLS (optional): if you enable HTTPS, note the Public Certificate, Private Key and (optionally) Chained Certificate you configure. Prepare the certificate and private key files or their PEM contents to paste/upload into FastMCP if the connection interface asks for them.
  6. Save and restart the adapter

    • Save the adapter settings in ioBroker Admin and restart the ioBroker.mcp adapter so the server listens on the configured host/port.
  7. Verify the running server and copy final values

    • Test the endpoint from your machine and confirm connectivity:
      • If no auth: curl http://:/status
      • If basic auth: curl -u : http://:/status
      • If HTTPS: use https:// and include cert handling as required.
    • Confirm the host, port, username/password (if used), and whether TLS is required — these are the values you will enter into FastMCP.
  8. Click "Install Now" and fill the FastMCP connection interface

    • Press the "Install Now" button.
    • In the FastMCP connection fields enter:
      • Host: the ioBroker host/IP you confirmed.
      • Port: the adapter port (default 8093).
      • Use TLS / SSL: enable if you configured HTTPS in the adapter.
      • Username / Password: fill these only if you enabled basic authentication in the adapter.
      • TLS certificate / private key: paste or upload PEM contents if FastMCP asks and you enabled HTTPS.
    • Leave other ENV fields blank — no additional ENV keys or API tokens are required for ioBroker.mcp.
  9. Final check

    • After FastMCP completes the install/connection, verify the MCP endpoints are reachable via FastMCP or directly:
      • GET / (server info), GET /status, GET /api/info, GET /api/capabilities.
  10. If you need to change credentials or TLS later

    • Return to ioBroker Admin → Adapters → ioBroker.mcp, update Username/Password or certificate paths, restart adapter, then update the values in the FastMCP connection interface accordingly.

Quick Start

View on GitHub

More for API Development

View All →

More for Developer Tools

View All →

Similar MCP Servers

Report Issue

Thank you! Your issue report has been submitted successfully.