Build Smart Home Skills for Cooking Appliances

Smart home skills created for cooking appliances like microwave ovens give customers voice access to cooking. This document provides an overview of the technical requirements for smart home skills that target cooking appliances.


When you use the Alexa.Cooking interfaces, the voice interaction model is already built for you. The following examples show some user utterances.

Alexa, cook a frozen pizza in the microwave.
Alexa, two minutes on the microwave.
Alexa, pause the microwave.
Alexa, restart the microwave.
Alexa, cook a two-and-a-half pound copper river salmon fillet in the microwave.

Get started

If this is your first time creating a Smart Home skill, review the existing documentation as a prerequisite to this document. You need to be familiar with how to create a Smart Home skill and write the code for a Lambda function that handles smart home requests from Alexa. For more information, see Steps to Create a Smart Home Skill.

Target v3 and English

In the developer console, when you create a skill for cooking appliances, you need to select v3 (preferred) and English (US) as the target version and language for the skill. This setting ensures your skill receives messages for requests related to cooking appliances.

Representing food

In the Alexa.Cooking interfaces, food is represented as a foodItem, which in turn contains a food name and a foodQuantity. A foodQuantity is specified as a count, a volume, or a weight. Alexa uses a small set of units to describe the count, weight or volume of a food, but you can choose from a larger list in your messages to Alexa. The supported values are described in the Volume.Unit and Weight.Unit enumerations.

Cooking modes

When a user asks to defrost or bake an item, Alexa identifies this as the cooking mode for the food. A cooking mode can be a predetermined cooking mode such as DEFROST, or a preset mode. You specify all of the cooking modes that your appliance supports in your discovery response. For more information, see CookingMode.

Alexa.Cooking Interfaces

The following are the available Alexa.Cooking interfaces.

In addition, you can use the more general smart home Alexa.TimeHoldController interface with your cooking devices that have pause and resume functionality.