What you can do with it

Monitor your fleet from chat

Ask Claude which devices are offline, what a sensor last read, or how a variable trended over the past week — without opening a dashboard.

Manage devices hands-free

Let an AI agent create devices, update device types, or reorganize device groups as you describe the change in plain language.

Act on incidents instantly

Open, acknowledge, comment on, or assign incidents through natural-language prompts — no need to touch the Ubidots UI.

Quick start guide

Get your API token

Grab your token from your Ubidots profile. It's what authenticates your AI client — no separate account or sign-up needed.

Add the Ubidots MCP server

Paste the endpoint (https://mcp.ubidots.com/mcp) and your token into your AI client's config. See Configuration below for exact steps per client.

Start asking

Ask about your devices, variables, or incidents in plain language. Your AI calls Ubidots directly and answers — no dashboard required.

Configuration

01
Claude Desktop
{
  "mcpServers": {
    "ubidots": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ubidots.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR UBIDOTS TOKEN>"
      }
    }
  }
}

Edit claude_desktop_config.json, paste this in, swap in your token, restart Claude Desktop.

02
Anthropic API
"authorization_token": "YOUR_UBIDOTS_TOKEN"
03
Other MCP-compatible clientes (Cursor, ChatGPT, etc.)

Any MCP-compatible client can connect directly to https://mcp.ubidots.com/mcp using your API token as a bearer token in the Authorization header. (The source article gives no client-specific steps beyond the two above — needs product/support input before publishing a full tab set.)

Available tools

Each category can be scoped to read-only or isolated to just that entity — see Authentication below.

Devices
  • List
  • Create
  • Update
Variables
  • List
  • Query statistics
  • Retrieve time-series data
  • Create
  • Update
Device Groups, Device Types & Organizations
  • Full CRUD
Events
  • Read-only
Incidents
  • Create
  • Acknowledge
  • Comment
  • Assign

Authentication

Ubidots MCP Server authenticates with your existing Ubidots API token — no separate account, no OAuth flow to set up.

Pass it as a bearer token in the Authorization header (Authorization: Bearer <your token>) — the same token you already use for the Ubidots REST API.

Need narrower access? Point your AI client at a scoped endpoint — see the table below — to restrict it to read-only, or to a single entity type — useful for giving an assistant the minimum access it needs.

Scope
Endpoint

Read-only, full API

https://mcp.ubidots.com/mcp/readonly

Devices only

https://mcp.ubidots.com/mcp/_/devices

Devices, read-only

https://mcp.ubidots.com/mcp/_/devices/readonly

(Same pattern for variables, device groups, device types, organizations, events, incidents)

FAQs

I'm getting a 401/Unauthorized error — what's wrong?

Check that your API token is valid and correctly formatted as Bearer <token> in the Authorization header — a missing "Bearer" prefix or an expired token are the most common causes.

My AI client can't reach the server

Confirm your network allows outbound HTTPS to mcp.ubidots.com, and that the endpoint is typed exactly as https://mcp.ubidots.com/mcp.

Some tools are missing

Check you're using the full endpoint, not a scoped read-only or entity-specific one — scoped endpoints intentionally expose fewer tools.

I see duplicate tools

Remove any duplicate server entries in your AI client's MCP config file — each server should be listed once.

Which AI clients does it work with?

Claude Desktop (macOS, Windows, Linux) and the Anthropic API today; any MCP-compatible client can also connect directly using the same endpoint and token.

Can I limit what the AI can see or change?

Yes — use a scoped endpoint (read-only, or limited to one entity type) instead of the full https://mcp.ubidots.com/mcp.