OpenHAB MCP Server

Name: OpenHAB MCP Server
Author: tdeckers

@tdeckers

Repository

About OpenHAB MCP Server

An MCP server for OpenHAB

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openhab-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--rm",
        "-p",
        "8081:8000",
        "\\"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenHAB MCP Server?

OpenHAB MCP Server is a Model Context Protocol (MCP) server that connects to a real openHAB instance via its REST API. It enables AI assistants like Claude and Cline to interact with your openHAB smart home system through natural language.

How to use OpenHAB MCP Server?

Run the server using the prebuilt Docker/Podman image from ghcr.io/tdeckers/openhab-mcp. Set the required environment variables OPENHAB_URL and OPENHAB_API_TOKEN (and optionally OPENHAB_USERNAME/OPENHAB_PASSWORD for basic auth). By default the server uses stdio; set MCP_MODE=remote to expose Streamable HTTP at /mcp and SSE at /sse. Configure Claude Desktop or Cline in VSCode by adding a JSON configuration entry that launches the container.

Key features of OpenHAB MCP Server

Manage items, things, rules, scripts, and links
Supports stdio, Streamable HTTP, and SSE transports
Provides MCP resources for listing items
Enables natural language control via AI assistants
Containerized deployment with a published image

Use cases of OpenHAB MCP Server

List all openHAB items in your system using a chat prompt
Update item states or create new items conversationally
Create, update, or delete things and their configurations
Run rules on demand and manage rule scripts
Clean up orphaned item-channel links

FAQ from OpenHAB MCP Server

What is required to run the OpenHAB MCP Server?

Python 3.7+ is required for local development, but the recommended deployment uses the prebuilt container image with Podman or Docker.

How do I authenticate with my openHAB instance?

Set the OPENHAB_URL and OPENHAB_API_TOKEN environment variables. If your openHAB uses basic authentication, additionally set OPENHAB_USERNAME and OPENHAB_PASSWORD.

What transport modes are supported?

The server supports stdio (default) and remote mode. In remote mode (MCP_MODE=remote), it exposes Streamable HTTP at http://HOST:PORT/mcp and SSE at http://HOST:PORT/sse.

How can I connect the server to Claude or Cline?

Add a JSON configuration entry to the Claude Desktop config file or the Cline mcp.json file that runs the container with the required environment variables. The README provides exact configuration examples for both.

What openHAB components can I manage?

You can manage items, things, rules, scripts, and item-channel links. The server provides tools for listing, creating, updating, deleting, and running these components.

Comments

More Other MCP servers

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K