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 Cast over the local network, from the user's Mac
A local bridge to the user's Home Assistant
Not supported yetAmazon Alexa · Apple Home
| Capability | Google Home | Home Assistant |
|---|---|---|
state.read | Coming soon | Coming soon |
telemetry.read | Not supported | Coming soon |
present.speak | Coming soon | Coming soon |
present.display | Coming soon | Coming soon |
act.set | Coming soon | Coming soon |
act.media | Coming soon | Coming soon |
act.lock | Not supported | Coming 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.readT0The 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_statusanddevice_commandin the same local MCP server, not in a release yet - Home AssistantComing soon
Sensor readings
telemetry.readT0Readings 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.speakT1A 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.displayT1A 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_showin the same local MCP server, not in a release yet - Home AssistantComing soon
Set a device
act.setT3A 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.mediaT3Stop, 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_statusanddevice_commandin the same local MCP server, not in a release yet - Home AssistantComing soon
Lock or unlock
act.lockT4Locks 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 returnsneeds_confirmationand 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