ThingsBoard MCP Server

Name: ThingsBoard MCP Server
Author: ThingsBoard

ThingsBoardOfficial

Get started Repository

Lets agents query and manage devices, assets, telemetry and other entities on a ThingsBoard IoT platform.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add thingsboard --env THINGSBOARD_URL='<THINGSBOARD_URL>' --env THINGSBOARD_USERNAME='<THINGSBOARD_USERNAME>' --env THINGSBOARD_PASSWORD='<THINGSBOARD_PASSWORD>' --env LOGGING_PATTERN_CONSOLE='<LOGGING_PATTERN_CONSOLE>' -- docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_USERNAME -e THINGSBOARD_PASSWORD mcp/thingsboard

~/.codex/config.toml

[mcp_servers.thingsboard]
command = "docker"
args = ["run", "-i", "--rm", "-e", "THINGSBOARD_URL", "-e", "THINGSBOARD_USERNAME", "-e", "THINGSBOARD_PASSWORD", "mcp/thingsboard"]
env = { THINGSBOARD_URL = "<THINGSBOARD_URL>", THINGSBOARD_USERNAME = "<THINGSBOARD_USERNAME>", THINGSBOARD_PASSWORD = "<THINGSBOARD_PASSWORD>", LOGGING_PATTERN_CONSOLE = "<LOGGING_PATTERN_CONSOLE>" }

# codex mcp add thingsboard --env THINGSBOARD_URL='<THINGSBOARD_URL>' --env THINGSBOARD_USERNAME='<THINGSBOARD_USERNAME>' --env THINGSBOARD_PASSWORD='<THINGSBOARD_PASSWORD>' --env LOGGING_PATTERN_CONSOLE='<LOGGING_PATTERN_CONSOLE>' -- docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_USERNAME -e THINGSBOARD_PASSWORD mcp/thingsboard

~/.cursor/mcp.json

{
  "mcpServers": {
    "thingsboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_USERNAME",
        "-e",
        "THINGSBOARD_PASSWORD",
        "mcp/thingsboard"
      ],
      "env": {
        "THINGSBOARD_URL": "<THINGSBOARD_URL>",
        "THINGSBOARD_USERNAME": "<THINGSBOARD_USERNAME>",
        "THINGSBOARD_PASSWORD": "<THINGSBOARD_PASSWORD>",
        "LOGGING_PATTERN_CONSOLE": "<LOGGING_PATTERN_CONSOLE>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "thingsboard": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_USERNAME",
        "-e",
        "THINGSBOARD_PASSWORD",
        "mcp/thingsboard"
      ],
      "env": {
        "THINGSBOARD_URL": "<THINGSBOARD_URL>",
        "THINGSBOARD_USERNAME": "<THINGSBOARD_USERNAME>",
        "THINGSBOARD_PASSWORD": "<THINGSBOARD_PASSWORD>",
        "LOGGING_PATTERN_CONSOLE": "<LOGGING_PATTERN_CONSOLE>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "thingsboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_USERNAME",
        "-e",
        "THINGSBOARD_PASSWORD",
        "mcp/thingsboard"
      ],
      "env": {
        "THINGSBOARD_URL": "<THINGSBOARD_URL>",
        "THINGSBOARD_USERNAME": "<THINGSBOARD_USERNAME>",
        "THINGSBOARD_PASSWORD": "<THINGSBOARD_PASSWORD>",
        "LOGGING_PATTERN_CONSOLE": "<LOGGING_PATTERN_CONSOLE>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "thingsboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_USERNAME",
        "-e",
        "THINGSBOARD_PASSWORD",
        "mcp/thingsboard"
      ],
      "env": {
        "THINGSBOARD_URL": "<THINGSBOARD_URL>",
        "THINGSBOARD_USERNAME": "<THINGSBOARD_USERNAME>",
        "THINGSBOARD_PASSWORD": "<THINGSBOARD_PASSWORD>",
        "LOGGING_PATTERN_CONSOLE": "<LOGGING_PATTERN_CONSOLE>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "thingsboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "THINGSBOARD_URL",
        "-e",
        "THINGSBOARD_USERNAME",
        "-e",
        "THINGSBOARD_PASSWORD",
        "mcp/thingsboard"
      ],
      "env": {
        "THINGSBOARD_URL": "<THINGSBOARD_URL>",
        "THINGSBOARD_USERNAME": "<THINGSBOARD_USERNAME>",
        "THINGSBOARD_PASSWORD": "<THINGSBOARD_PASSWORD>",
        "LOGGING_PATTERN_CONSOLE": "<LOGGING_PATTERN_CONSOLE>"
      }
    }
  }
}

Environment variables

THINGSBOARD_URL
THINGSBOARD_USERNAME
THINGSBOARD_PASSWORD
LOGGING_PATTERN_CONSOLE

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related