thingsboard-mcp-server MCP Server

A Model Context Protocol (MCP) server for ThingsBoard. This project allows AI assistants (like Claude Desktop) to interact directly with your ThingsBoard instance to manage assets, devices…

Local serverstdio

What is the thingsboard-mcp-server MCP Server?

thingsboard-mcp-server is an MCP project maintained in the pophalea/thingsboard-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for ThingsBoard. This project allows AI assistants (like Claude Desktop) to interact directly with your ThingsBoard instance to manage…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using python3. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares TB_URL, TB_USERNAME, TB_PASSWORD, TB_EDITION. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the thingsboard-mcp-server MCP Server

{
  "mcpServers": {
    "thingsboard": {
      "command": "python3",
      "args": [
        "/absolute/path/to/thingsboard-mcp/thingsboard_mcp/main.py"
      ],
      "env": {
        "TB_URL": "http://YOUR_TB_IP:8080",
        "TB_USERNAME": "tenant@thingsboard.org",
        "TB_PASSWORD": "YOUR_TB_PASSWORD",
        "TB_EDITION": "CE"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TB_URLDeclared in the maintainer’s client configuration.Check documentation
TB_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
TB_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
TB_EDITIONDeclared in the maintainer’s client configuration.Check documentation