Skip to main content
MCP server CX Codex

ThingsBoard — Claude Code MCP server: features and setup

This MCP server connects an AI agent to ThingsBoard to query device data and manage IoT entities. You’ll need a ThingsBoard instance and credentials to connect.

no license updated 2026-10-29

Open on GitHub

What ThingsBoard does

The server gives an agent tools for working with ThingsBoard devices, assets, customers, users, and alarms. It can retrieve telemetry, inspect time-series data, and navigate relationships between entities. Other tools cover OTA packages and entity groups in PE.

Run it with Docker. STDIO suits clients that start the server as a subprocess; SSE serves clients connecting over HTTP. A ThingsBoard instance is required, along with an API key or username and password. For ThingsBoard versions earlier than 4.3, use the older username-and-password login instead of an API key. Without the instance URL, the server has nowhere to connect.

What it helps with

  • list devices in a ThingsBoard instance
  • read a device’s telemetry for a time range
  • create or update an IoT entity
  • find alarms by severity
  • inspect relationships between entities

Example prompts for the agent

  • List the ThingsBoard devices and find one by name.
  • Read the selected device’s time-series telemetry for this period.
  • Find high-severity alarms and show their related entities.

How to install ThingsBoard

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about ThingsBoard

How do I set up ThingsBoard in Claude Code?

Configure the ThingsBoard MCP server for Claude Code using Docker. Set the instance address in THINGSBOARD_URL and provide a key with THINGSBOARD_API_KEY; for ThingsBoard versions earlier than 4.3, use THINGSBOARD_USERNAME and THINGSBOARD_PASSWORD.

What does the ThingsBoard MCP server do?

It lets an AI agent query telemetry and manage ThingsBoard entities, including devices, assets, customers, users, and alarms.

What credentials does the ThingsBoard server need?

Provide the instance URL and either an API key or a username and password. The API-key option is described for ThingsBoard 4.3 and later.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open