Home Automation & IoT · Developer Tools

Thingsboard MCP logo

Thingsboard MCP

thingsboard/thingsboard-mcp

Connect AI agents to your ThingsBoard IoT platform via Model Context Protocol (MCP). Query devices, manage entities, analyze telemetry, and automate operations — all through natural language.

Install

docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

Client configuration

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

Environment variables

THINGSBOARD_URLTHINGSBOARD_API_KEY
Category
Home Automation & IoT, Developer Tools
License
Apache-2.0
Updated
Oct 6, 2026

About Thingsboard MCP

Works with Claude Desktop, Cursor, VS Code Copilot, Claude Code, and any MCP-compatible client.

Features

  • Devices — create, update, delete, list, search by name/type/group

  • Assets — CRUD, list by tenant/customer, search

  • Customers — CRUD, list, search by title

  • Users — CRUD, list, admin/customer user management

  • Alarms — create, acknowledge, clear, delete, query by severity

  • Telemetry — read/write attributes and time-series, aggregation, TTL

  • Relations — create, delete, navigate entity relationships

  • OTA Packages — upload, download, assign firmware/software to devices

  • Entity Groups (PE) — manage groups, assign/remove entities

  • Entity Data Query — complex filtered queries across all entity types with attribute/telemetry filters

Tools (40)

  • THINGSBOARD_TOOLS_EDQ

    Entity Data Query + Guides

  • THINGSBOARD_TOOLS_TELEMETRY

    Telemetry & Attributes

  • THINGSBOARD_TOOLS_DEVICE

  • THINGSBOARD_TOOLS_ASSET

  • THINGSBOARD_TOOLS_ALARM

  • THINGSBOARD_TOOLS_OTA

    OTA Packages

  • THINGSBOARD_TOOLS_RELATION

    Relations

  • THINGSBOARD_TOOLS_CUSTOMER

    Customers

  • THINGSBOARD_TOOLS_USER

  • THINGSBOARD_TOOLS_GROUP

    Entity Groups (PE only)

  • createOrUpsertDevice

    Create or update a device by name.

  • saveDevice

    Create or update the device object from raw JSON.

  • deleteDevice

    Delete the device by id.

  • getDeviceById

    Fetch the Device object based on the provided Device Id.

  • getDeviceCredentialsByDeviceId

    Get device credentials by device id.

  • getTenantDevices

    Returns a page of devices owned by tenant.

  • getTenantDevice

    Get tenant device by name.

  • getCustomerDevices

    Returns a page of devices assigned to customer.

  • getUserDevices

    Returns a page of devices available for the current user.

  • getDevicesByIds

    Get devices by ids.

  • getDevicesByEntityGroupId

    Returns a page of devices in a specified entity group.

  • saveAsset

    Create or update the asset object.

  • deleteAsset

    Delete the asset by id.

  • getAssetById

    Get the Asset object by id.

  • getTenantAssets

    Returns a page of assets owned by tenant.

  • getTenantAsset

    Get tenant asset by name.

  • getCustomerAssets

    Returns a page of assets assigned to customer.

  • getUserAssets

    Returns a page of assets available for the current user.

  • getAssetsByEntityGroupId

    Returns a page of assets in a specified entity group.

  • saveCustomer

    Create or update the customer object.

  • deleteCustomer

    Delete the customer by id.

  • getCustomerById

    Get the Customer object by id.

  • getCustomers

    Returns a page of customers owned by tenant.

  • getTenantCustomer

    Get customer by title.

  • getUserCustomers

    Returns a page of customers available for the user.

  • getCustomersByEntityGroupId

    Returns a page of customers in a specified entity group.

  • saveUser

    Create or update the user object.

  • deleteUser

    Delete the user by id.

  • getUserById

    Fetch the User object by id.

  • getUsers

    Returns a page of users owned by tenant or customer.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
rulego logo

rulego

rulego/rulego

1.1k

RuleGo also provides a large number of reusable components that support the aggregation, filtering, distribution, transformation, enrichment, and execution of various actions on data, and can also interact and integrate with various protocols and systems.

Home Automation & IoT
Homeassistant MCP logo

Homeassistant MCP

tevonsb/homeassistant-mcp

246

A powerful bridge between your Home Assistant instance and Language Learning Models (LLMs), enabling natural language control and monitoring of your smart home devices through the Model Context Protocol (MCP). This server provides a comprehensive API for managing your entire Home Assistant ecosystem, from device control to system administration.

Home Automation & IoT
MCP Server Apple Shortcuts logo

MCP Server Apple Shortcuts

recursechat/mcp-server-apple-shortcuts

145

A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.

Home Automation & IoT
Siri Shortcuts logo

Siri Shortcuts

dvcrn/mcp-server-siri-shortcuts

115

This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.

Home Automation & IoT
Hass MCP logo

Hass MCP

voska/hass-mcp

60

A Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs.

Home Automation & IoT
MCP Server Home Assistant logo

MCP Server Home Assistant

allenporter/mcp-server-home-assistant

45

A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.

Home Automation & IoT