# ThingsBoard

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: thingsboard
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thingsboard/thingsboard-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/thingsboard

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

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

## When to use it
- 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
- 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.

## Similar
- [iot-anomalies](https://affpapa.org/en/nevibecode/skills/iot-anomalies.md) — skill · 731 installs
- [iot-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-iot-engineer.md) — subagent · ★ 6505 repo stars
- [sensor-data-aggregator](https://affpapa.org/en/nevibecode/skills/sensor-data-aggregator.md) — skill · 129 installs
- [json-parser](https://affpapa.org/en/nevibecode/skills/json-parser.md) — skill · 115 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 128300 installs
- [Bagel](https://affpapa.org/en/nevibecode/mcp/bagel.md) — MCP server · ★ 407 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
