Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Adafruit IO

Scalekit connector
Open markdown

The Adafruit IO connector lets your AI agent act in each user's Adafruit IO account. Each user connects their own Adafruit IO API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

Tools
59
What they doRead · write · destructive
25 · 25 · 925 read25 write9 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Adafruit IO connection

    In AgentKit > Connections, create an Adafruit IO connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'adafruitio'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Adafruit IO:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'adafruitio_user_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Adafruit IO credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • adafruitio_action_getGet one Action with its definition and recent run logs.Read-only

    Get Action

    Get one Action with its definition and recent run logs. Returns run_status, validation_status, validation errors, watched feeds and the last run log. Use this to debug an action. Get IDs from adafruitio_actions_list.

    Inputs

    idintegerrequired
    Action ID. Example: 42.
    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
  • adafruitio_actions_listList your Adafruit IO Actions (automations triggered by feed data or schedules).Read-only

    List Actions

    List your Adafruit IO Actions (automations triggered by feed data or schedules). Returns each action's id, name, run_status and validation_status. Use this to find action IDs. Use adafruitio_action_get to see why an action isn't running.

    Inputs

    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
  • adafruitio_activities_by_type_listList recent activity for one kind of object, such as feeds or dashboards.Read-only

    List Activities by Type

    List recent activity for one kind of object, such as feeds or dashboards. Returns activity records. Use adafruitio_activities_list for everything.

    Inputs

    typestringrequired
    Object type to filter on, for example feed, group, dashboard or block. Example: feed.
    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
    end_timestring
    Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
    limitinteger
    Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
    start_timestring
    Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
  • adafruitio_activities_listList recent activity in your account: creates, updates and deletes of feeds, groups, dashboards and more.Read-only

    List Activities

    List recent activity in your account: creates, updates and deletes of feeds, groups, dashboards and more. Returns activity records with action, model and timestamp. Use adafruitio_activities_by_type_list for one kind of object.

    Inputs

    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
    end_timestring
    Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
    limitinteger
    Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
    start_timestring
    Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
  • adafruitio_block_getGet one dashboard block.Read-only

    Get Dashboard Block

    Get one dashboard block. Returns its visual type, feeds, properties and position. Get block IDs from adafruitio_blocks_list.

    Inputs

    dashboard_keystringrequired
    Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
    idstringrequired
    Block ID. Example: 1234.
    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
  • adafruitio_blocks_listList the blocks (widgets) on a dashboard.Read-only

    List Dashboard Blocks

    List the blocks (widgets) on a dashboard. Returns each block's id, name, visual type, feeds and size. Use this to find block IDs.

    Inputs

    dashboard_keystringrequired
    Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
  • adafruitio_dashboard_getGet one dashboard by key.Read-only

    Get Dashboard

    Get one dashboard by key. Returns its name, key, visibility, layout settings and blocks. Get dashboard keys from adafruitio_dashboards_list.

    Inputs

    dashboard_keystringrequired
    Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
  • adafruitio_dashboards_listList all dashboards in your account.Read-only

    List Dashboards

    List all dashboards in your account. Returns each dashboard's id, name, key and visibility. Use this to find dashboard keys.

    Inputs

    usernamestringrequired
    Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.