Smart home Coming soon

Speakers, smart displays and home devices: speech, cards, state and reversible actions

Google Home cannot answer a question: Cast carries no answer back from the speaker. It does report what it is playing, its volume and the commands it accepts right now, so your agent reads those instead of guessing.

Models

Google HomePlanned

Google Cast over the local network, from the user's Mac

Home AssistantPlanned

A local bridge to the user's Home Assistant

Not supported yetAmazon Alexa · Apple Home

CapabilityGoogle HomeHome Assistant
state.readComing soonComing soon
telemetry.readNot supportedComing soon
present.speakComing soonComing soon
present.displayComing soonComing soon
act.setComing soonComing soon
act.mediaComing soonComing soon
act.lockNot supportedComing soon

Keys, connecting a user's device, permissions, routing, errors and test mode work the same for every category: see Projects, environments and keys, Connect a device, Permissions and safety, Errors and Test mode. The examples assume a dopl client and a deviceId from the Quickstart.

What your agent receives

Device state

state.readT0

The current state of a home device, such as what a speaker is playing or whether a light is on, with the commands it accepts right now.

Limits
  • Google Home: the playing app, track, player state and volume, read from the speaker when asked. Commands are listed from what the device reports, never per app.
Permission
Scope state.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id } = await dopl.devices.action(deviceId, "state.read", {});
const action = await dopl.actions.get(action_id);
console.log(action.result);

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "device_id": "8b0c6f1e-3d2a-4c51-9a7e-2f4d6b1c9e30",
  "capability": "state.read",
  "status": "done",
  "result": {
    "simulated": true
  },
  "error": null,
  "created_at": "2026-10-27T17:05:00Z",
  "updated_at": "2026-10-27T17:05:09Z"
}

Supported on

  • Google HomeComing soonBuilt as device_status and device_command in the same local MCP server, not in a release yet
  • Home AssistantComing soon

Sensor readings

telemetry.readT0

Readings such as temperature or energy use.

Limits
  • Set by each device's descriptor. No model in this category is connected yet.
Permission
Scope state.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id } = await dopl.devices.action(deviceId, "telemetry.read", {});
const action = await dopl.actions.get(action_id);
console.log(action.result);

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "device_id": "8b0c6f1e-3d2a-4c51-9a7e-2f4d6b1c9e30",
  "capability": "telemetry.read",
  "status": "done",
  "result": {
    "simulated": true
  },
  "error": null,
  "created_at": "2026-10-27T17:05:00Z",
  "updated_at": "2026-10-27T17:05:09Z"
}

Supported on

  • Home AssistantComing soon

What your agent can send

Speak

present.speakT1

A message said out loud on a speaker. It interrupts what the speaker is playing.

Limits
  • Google Home: 500 characters, at the speaker's current volume. The Mac must be awake on the same network.
Permission
Scope present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "present.speak", {
  text: "Your build finished. All tests passed."
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "done"
}

Supported on

  • Google HomeComing soonBuilt as a local MCP server in the Dopl desktop app (google_home_notify), not in a release yet
  • Home AssistantComing soon

Show a card

present.displayT1

A card on a smart display, optionally read aloud.

Limits
  • Google Home: Nest Hub and Nest Hub Max only. Title up to 80 characters and up to 6 lines of 120.
Permission
Scope present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "present.display", {
  blocks: [
    {
      id: "title",
      type: "heading",
      text: "Flight UA 212"
    }
  ]
});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "done"
}

Supported on

  • Google HomeComing soonBuilt as google_home_show in the same local MCP server, not in a release yet
  • Home AssistantComing soon

Set a device

act.setT3

A reversible change such as turning on a light. The arguments are defined with the first home adapter.

Limits
  • Set by each device's descriptor. No model in this category is connected yet.
Permission
Scope act.*, unticked on the consent screen until the user ticks it. At call time: allowed when ticked, unless your profile asks for confirmation or denies the tier. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "act.set", {});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "done"
}

Supported on

  • Google HomeComing soonPlanned through Google's Home APIs
  • Home AssistantComing soon

Control media

act.mediaT3

Stop, pause, resume or change the volume of whatever a speaker or TV is playing, from any app.

Limits
  • Google Home: stop, pause, play, set_volume, mute and unmute, each only while the device lists it. Choosing what to play is not covered.
Permission
Scope act.*, unticked on the consent screen until the user ticks it. At call time: allowed when ticked, unless your profile asks for confirmation or denies the tier. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "act.media", {});

Example response

{
  "action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
  "status": "done"
}

Supported on

  • Google HomeComing soonBuilt as device_status and device_command in the same local MCP server, not in a release yet
  • Home AssistantComing soon

Lock or unlock

act.lockT4

Locks are T4, so the default profile denies them even when the user ticked them.

Limits
  • Set by each device's descriptor. No model in this category is connected yet.
Permission
Scope act.*, unticked on the consent screen until the user ticks it. At call time: denied by default, even when ticked. With a confirmation mode in your profile, every call returns needs_confirmation and does not run. See Permissions and safety.

Call

const { action_id, status } = await dopl.devices.action(deviceId, "act.lock", {});

Example response

{
  "error": {
    "type": "permission_error",
    "code": "confirmation_denied",
    "message": "act.lock is T4 and the profile denies it.",
    "retryable": false,
    "doc_url": "https://www.usedopl.com/docs/errors/confirmation-denied"
  }
}

Supported on

  • Home AssistantComing soon