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 GitHubWhat 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.