• TAGGING
  • CONFIG
  • AUDIT
  • HUMAN

How to manage device metadata with your AI

Connect Balena to your AI client to automate how you label and configure your hardware fleet.

Ask AI about this page

Short answer

How can I use AI to organize my Balena devices?

Your AI reads your current device list and applies tags or environment variables to specific hardware based on your instructions. This keeps your inventory organized without manual dashboard updates.

Metadata outcomes

Where your data lands

What happens when your AI interacts with Balena.

TAGGING

Organized hardware groups

The AI applies specific labels to devices. You can then group or filter your fleet based on these custom tags.

CONFIG

Dynamic environment variables

Your agent sets variables on specific devices. This allows you to push configuration changes through chat.

AUDIT

Inventory visibility

The AI pulls your current device list. You get a clear view of what is connected and how it is currently tagged.

HUMAN

Manual oversight

You decide which devices get updated. The AI proposes the changes, but you maintain control over the fleet.

The workflow

What your AI does when the request arrives.

The AI moves from reading your fleet to applying specific metadata updates.

  1. Scan the fleet

    The AI pulls a full list of your connected hardware to see what is available for updates.

    list_devices

  2. Identify targets

    Your agent looks through the device list to find the specific hardware you mentioned in your prompt.

    list_devices

  3. Apply labels

    The AI attaches a new tag to the selected device to categorize it.

    create_device_tag

  4. Set variables

    The agent writes environment variables to the device to change how its software behaves.

    create_device_env_var

Try it

Copy these to start.

Use these prompts to begin managing your Balena fleet.

Starting points

Replace the bracketed text with your actual device names or tag values.

Balena Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_HaDxWZjxy0KnKuRGaidiaMAMaJh5YZgXdeQzTr9y/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Balena capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "balena-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_HaDxWZjxy0KnKuRGaidiaMAMaJh5YZgXdeQzTr9y/mcp"
    }
  }
}
Copy into chat04

  • List all my devices so I can see what is online.

  • Add a tag called 'production' to the device named 'edge-gateway-01'.

  • Set an environment variable 'LOG_LEVEL' to 'debug' on my 'sensor-node-alpha' device.

  • Find all devices tagged with 'test-fleet' and add a 'verified' tag to them.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Balena once, then ask.

One connection links your Balena account to your AI client. Your credentials stay encrypted, and you can start managing devices immediately.

Connect Balena to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete devices from my Balena account?

    No. The AI only has tools to list, tag, and set environment variables. It cannot delete hardware.

  • 02

    Will the AI change my device settings without asking?

    No. The AI performs the actions you explicitly request in your chat prompts.

  • 03

    Can I use the AI to update firmware?

    No. This MCP is limited to managing metadata like tags and environment variables.

  • 04

    How does the AI know which device I am talking about?

    The AI uses the list of devices to match the names or IDs you provide in your instructions.

  • 05

    Can the AI remove existing environment variables?

    No. The current tools only allow for creating or updating variables, not deleting them.

  • More questions about Balena? The Connector page answers them. See everything the Balena Connector can do

Connect Balena to Claude, Cursor, ChatGPT & more