Skip to main content

Ubidots MCP Server

Create AI applications that interact with your data

Sergio M avatar
Written by Sergio M
Updated over 2 weeks ago

Overview

The Model Context Protocol (MCP) lets AI applications securely connect to external APIs. In IoT projects, that means your AI application can automatically decide whether it needs to call Ubidots API in order to reply to a user prompt.
​

Examples:

  • “Which devices are offline?”

  • “Show the last values of temperature for device aws810.”

  • "What was the average temperature yesterday of Machine ABC"

In this article we explore using Ubidots MCP from:

  • Claude Desktop

  • Anthropic API

Using Ubidots MCP server from Claude Desktop

Prerequisites

  • A Ubidots account and Ubidots API token (scoped for the org you want to use).

  • Claude Desktop installed (macOS/Windows/Linux).

Step-by-step

  1. Open Claude Desktop Settings
    Launch Claude Desktop → Settings → Developer.

  2. Edit Config
    Click Edit config to open claude_desktop_config.json.

  3. Add the Ubidots MCP server entry
    Paste the snippet below into the JSON (merge with your existing mcpServers if present).
    Replace <YOUR UBIDOTS TOKEN> with your actual token.

    {
        "mcpServers": 
            { 
                "ubidots": 
                    { 
                        "command": "npx", 
                        "args": [ "mcp-remote", "https://mcp.ubidots.com/mcp", "--header", "x-auth-token: <YOUR UBIDOTS TOKEN>" 
                        ] 
                    }
            } 
    }

    Notes

    • If mcpServers already exists, add only the "ubidots" block inside it.

    • Keep JSON syntax valid (commas, braces).

  4. Save & Reload Claude
    Save the file and restart Claude Desktop (or use “Reload” if available).

  5. Verify the connection


    In a new Claude chat, make sure the MCP is enabled and try this:

    • “Which devices are online?"

    If configured correctly, Claude should confirm the MCP tool is available and return live data from Ubidots.

Troubleshooting

Claude doesn’t show the Ubidots tool

  • Restart Claude after editing the config.

  • Check JSON validity (use an online JSON linter if needed).

  • Ensure npx is available in your system PATH.

401 / Unauthorized

  • Verify the header is exactly: x-auth-token: <YOUR UBIDOTS TOKEN>.

  • Check the token hasn’t expired or been revoked.

Network errors

  • Confirm you’re online and not behind a proxy/firewall blocking outbound HTTPS.

  • Try again later in case of transient network issues.

Multiple MCP servers configured

  • Make sure there are no duplicate keys named ubidots.

  • If you renamed the server, remember the name you’ll see inside Claude will match that key.

Updating or Removing the Integration

  • Update token: Open claude_desktop_config.json, replace the token in the header, save, and reload Claude.

  • Disable: Remove or comment out the "ubidots" block under mcpServers, save, and reload Claude.

Using Ubidots MCP server with Anthropic API

While Claude Desktop is great for testing, it does not resemble real world scenarios, where users will want to interact with an AI agent through Slack, Whatsapp, or a web-based chat box within your Ubidots-powered application.

In such scenarios, using an AI API such as OpenAI API or Anthropic API will enable you to add the required layer of intelligence to your use case.

Here's a sample request you'd use from such an application in order to interact with both your user queries, and Ubidots MCP:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-04-04" \
  -d '{
    "model": "claude-3-5-sonnet-20240620",
    "max_tokens": 500,
    "system": "You're smart IoT assistant. If you need device data, use the attached MCP.",
    "messages": [
      {"role": "user", "content": "List my devices"}
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "ubidots",
        "url": "https://mcp.ubidots.com/mcp",
        "authorization_token": "YOUR_UBIDOTS_TOKEN"
        }
      }
    ]
  }'

To learn more about Anthropic MCP connector, please visit their official documentation.

FAQ

Does this work with other MCP clients?
Yes. Any MCP-compatible client can connect to https://mcp.ubidots.com/mcp using the same x-auth-token header.

Is the server local?
No. The Ubidots MCP Server is cloud-hosted; saving you the need to run it locally, and enabling applications such as Whatsapp AI bots.

Can I use multiple Ubidots accounts?
Yes—create separate entries (e.g., ubidots-prod, ubidots-staging) with different tokens.

Example Prompts to Get You Started

  • “List organizations and show device counts for each.”

  • “For device aws810, list variables and show last timestamps and values.”

If you run into issues or have feature requests for the Ubidots MCP Server, let us know what client you’re using, your OS, and a redacted copy of your mcpServers config so we can help faster.

Related Articles
Plugins: Connect Helium with Ubidots
Integrate your LORIOT data with Ubidots using UbiFunctions
Events: Manage downlink messages with LORIOT and Ubidots
Integrate your ChirpStack Data with Ubidots
Connect Teltonika TRB140 Modbus IoT Gateway to Ubidots using HTTP
Did this answer your question?