Basic Commands

Now that your Mycroft Device is Paired with home.mycroft.ai, you may begin issuing commands. Try these to get started.

You issue a command to Mycroft by Speaking the Wake Word (e.g. "Hey Mycroft"), awaiting acknowledgement from Mycroft, and then Speaking the command itself (aka the utterance).

When you issue a command, you intend for Mycroft to react in a certain way. Your utterance contains an Intent. Mycroft uses natural language processing to compare the words in your utterance to expected phrases or keywords as supplied by the installed Skills. When Mycroft determines that there is a match between your utterance and a specific expectation (the phrases/keywords), the Skill that supplied the matching expectation is notified so that it can respond to your command.

Mycroft comes with a collection of Skills installed by default. Each Skill supplies a set of Intents, and each Intent has a set of expected phrases or keywords. Each of the default Skills is introduced below with a brief description, followed by a sampling of expected utterances (usually grouped by Intent). Additional Skills may be added to your Mycroft Device; please see Installing New Skills.

Have fun exploring natural language processing by trying these commands with variations to the wording and phrasing.

The Default Skills

Alarm

Manages a collection of alarms. Weekly repetition is supported.

Set an alarm

Hey Mycroft, wake me in two hours Hey Mycroft, wake me up at 10:23pm Hey Mycroft, set an alarm for two hours Hey Mycroft, set an alarm for 3pm Hey Mycroft, add an alarm for Monday at 8:20 Hey Mycroft, create alarms for every weekday at 6 Hey Mycroft, start a repeating alarm for Fridays at 9:30pm Hey Mycroft, set an alarm <- - - - - Mycroft will ask WHEN

Snooze the active alarm

Hey Mycroft, snooze <- - - - - Defaults to 9 minutes Hey Mycroft, snooze for 15 minutes Hey Mycroft, give me 2 more hours

Delete/stop/cancel/dismiss/remove

Hey Mycroft, stop the alarm Hey Mycroft, delete the Tuesday alarm for 9 Hey Mycroft, remove all alarms

Query alarms

Hey Mycroft, when is the next alarm? Hey Mycroft, what are the alarms for today?

Change alarm sound

Hey Mycroft, change the sound of the alarm

Audio Record

Captures audio to a file that can be played back. The file can be deleted.

Record

Duration is 60-seconds unless overridden. The new duration value is used until it is overridden.

Hey Mycroft, record Hey Mycroft, record audio Hey Mycroft, start recording Hey Mycroft, record me for 6 seconds

Playback

Hey Mycroft, play record Hey Mycroft, play back the audio Hey Mycroft, playback recording

Delete the file

Hey Mycroft, delete audio Hey Mycroft, erase recording Hey Mycroft, record clear

Configuration

Interacts with the Device configuration both locally and at home.mycroft.ai.

Query the registered name of this Mycroft Device

Hey Mycroft, what is your name?

Query the registered location of this Mycroft Device

Hey Mycroft, where are you? Hey Mycroft, tell me your state

Query which listener is being used to detect the Wake Word

Hey Mycroft, tell me the wake word listener Hey Mycroft, what is the listener?

Command Mycroft to update the configuration both locally and at home.mycroft.ai

Hey Mycroft, configuration update Hey Mycroft, update config

For developers: Select which listener to use

Hey Mycroft, set the listener to precise Hey Mycroft, set the listener to default

For developers: Enable or disable the development version of Precise listener

Hey Mycroft, enable the precise dev model Hey Mycroft, disable the new precise model

Date & Time

Mycroft answers inquiries about Dates (specific dates, relative dates, holidays, leap year, weekends, etc.) and Time (future or current, local or other location). Mycroft's response to a Date inquiry attempts to supply the 'missing information' and selectively includes: day-of-week, the calendar date, and the quantity of days from now. When answering inquiries about Time, Mycroft may optionally take advantage of the display on the enclosure.

Query current time (in location)

Hey Mycroft, the time now please Hey Mycroft, what time is it in Paris?

Query future time (in location)

Hey Mycroft, what time will it be in 2 hours? Hey Mycroft, tell me the time 6 hours from now in Paris?

On some enclosures: Display the time (in location)

Hey Mycroft, display the time Hey Mycroft, display the time in Paris

Query a holiday

Hey Mycroft, when is Labor Day? Hey Mycroft, what day is Christmas in 2025?

Query next leap year

Hey Mycroft, when is the next leap year?

Query a specific date

Hey Mycroft, when in July 1st?

Query a relative date

Hey Mycroft, what is today's date? Hey Mycroft, what is today? Hey Mycroft, when is next Tuesday? Hey Mycroft, what is 6 days from now? Hey Mycroft, when in next Friday?

Query weekend dates

Hey Mycroft, what was last weekend? Hey Mycroft, what were the days last weekend? Hey Mycroft, what are the dates this weekend? Hey Mycroft, what are the days for next weekend?

Hello World

Hello World is a well-documented Skill that serves as a starting point for code development. Pleasantries with Mycroft are used as examples.

Hey Mycroft, greetings Hey Mycroft, hello world

Hey Mycroft, thank you

Hey Mycroft, how are you doing? Hey Mycroft, how was your day?

IP

Query the SSID or the IP Address (aka the network address) of the Mycroft Device.

Query the IP address

Hey Mycroft, what is your IP address? Hey Mycroft, tell me your network address Hey Mycroft, what network are you connected to?

Query the SSID

Hey Mycroft, what SSID are you on? Hey Mycroft, what wifi network are you using? Hey Mycroft, what network are you connected to?

Jokes

Mycroft uses pyjokes as the source of jokes to tell.

Hey Mycroft, tell me a joke Hey Mycroft, make me laugh Hey Mycroft, brighten my day with a Chuck Norris joke Hey Mycroft, tell me a non-offensive joke

Naptime

While 'napping' Mycroft will ignore utterances other than "Wake up".

Begin nap

Hey Mycroft, go to sleep Hey Mycroft, nap time

End nap

Hey Mycroft, wake up

NPR News

Plays the RSS audio feed for the requested station. If no station is specified or if the request is unknown, a default station is selected based on Device location. Stations include: ABC (Australia), AP, BBC, CBC, DLF, Ekot, FOX, GPB, NPR, PBS, RDP, RNE, TSF, OE3, VRT, WDR, YLE.

Play the news

Hey Mycroft, what's the news? Hey Mycroft, play the BBC news Hey Mycroft, what are the headlines?

Restart the broadcast

Hey Mycroft, start over Hey Mycroft, restart news

Stop playing the news

Hey Mycroft, stop

Personal

Ask about the "birth" and parentage of Mycroft, and get a taste of the community fostering this open source artificial intelligence.

Hey Mycroft, who are you? Hey Mycroft, when were you created? Hey Mycroft, what are you? Hey Mycroft, where were you born? Hey Mycroft, who made you? Hey Mycroft, do you even rhyme? Hey Mycroft, do you dream?

Playback Control

Common commands for controlling a music service.

Pause the music

Hey Mycroft, pause Hey Mycroft, pause the song

Resume the paused music

Hey Mycroft, resume song Hey Mycroft, resume play

Next track

Hey Mycroft, next track

Previous track

Hey Mycroft, previous track

Play

User provides a genre/artist/title/playlist/service. Depending on the music service, a dialog may be initiated.

Hey Mycroft, play my summer playlist Hey Mycroft, play Pandora Hey Mycroft, play something by hermitude Hey Mycroft, play uptown funk on youtube

Reminder

Manages a collection of reminders. A Reminder is similar to an Alarm but instead of a beep Mycroft speaks the User specified words.

Set a reminder

Hey Mycroft, remind me to turn off the oven in 5 minutes Hey Mycroft, add a reminder to let the dog out at 3pm Hey Mycroft, remind me to take out the trash <- - - Mycroft will ask WHEN Hey Mycroft, remind me at 5pm <- - - - - - - - - Mycroft will ask FOR WHAT Hey Mycroft, set a reminder for me <- - - Mycroft will ask WHEN and FOR WHAT

Snooze the active reminder

Hey Mycroft, snooze the reminder Hey Mycroft, remind me later

Cancel the active reminder

Hey Mycroft, okay, stop the reminder

Get reminders for a specific day

Hey Mycroft, what are my reminders for today? Hey Mycroft, do I have any reminders tomorrow?

Get next reminder

Hey Mycroft, what is my next reminder?

Delete all reminders for a specific day

Hey Mycroft, cancel today's reminders Hey Mycroft, cancel all reminders for tomorrow

Delete all reminders

Hey Mycroft, delete all reminders

Singing

Mycroft will speak the lyrics to a random pop music song.

Hey Mycroft, sing Hey Mycroft, sing me a song

Speak

Speak a phrase and have Mycroft repeat it.

Hey Mycroft, speak Mary had a little lamb Hey Mycroft, say yada yada yada Hey Mycroft, repeat hey good looking

Spelling

Mycroft will spell any word that is understood by the Speech-To-Text system.

Hey Mycroft, spell aardvark Hey Mycroft, what is the spelling of aardvark? Hey Mycroft, how do you spell word aardvark?

Stock

This Skill has been disabled.

Stop

Tell Mycroft to STOP doing whatever it is doing. Should work with all Skills.

Hey Mycroft, stop Hey Mycroft, silence Hey Mycroft, shut up

Support Helper

Captures troubleshooting information from the Mycroft Device and stores it on the 0x0.st storage service. This information is useful for your own debugging and for communicating with Support. A link to the information is emailed to the address registered at home.mycroft.ai.

Hey Mycroft, contact support Hey Mycroft, create a support ticket Hey Mycroft, troubleshoot my device Hey Mycroft, create a troubleshoot request

Timer

Manages a collection of timers. Timers are requested with a duration expressed in hours, minutes, and/or seconds. A timer may optionally be given a name. The name is useful in queries, subsequent commands, and for display purposes. All timers beep.

  • If you wish to command a specific expiration time (e.g. 'at 3:05pm'), please use either an Alarm or a Reminder.

  • Timers have a duration of less than 24-hours. When a Timer is requested with a duration greater than 24-hours, an Alarm is set instead.

  • Mycroft refers to a timer by it's original duration and the optional User supplied name.

  • When there is more than one timer with the same duration, Mycroft may include an ordinal (e.g. the second timer for 5-minutes).

  • The User may refer to an individual timer by its name or by the ordinal of its position in the list of timers (e.g. the third timer).

Start a timer

Hey Mycroft, I need a timer named turkey for 15 minutes Hey Mycroft, start a 10-minute timer called time to go Hey Mycroft, set a timer to take out the trash <- - - Mycroft will ask for the DURATION Hey Mycroft, ping me in 2 hours <- - - - - - - - - No NAME is associated with this timer Hey Mycroft, Start a timer <- - - - - - - - Mycroft will ask for the DURATION but not a NAME Hey Mycroft, Begin timer

Query a timer

Hey Mycroft, how's my turkey timer? Hey Mycroft, how much time is left?

Cancel the beeping timer

Hey Mycroft, cancel the timer

Cancel a timer in the list of timers

Hey Mycroft, cancel the first timer Hey Mycroft, delete the fourth timer Hey Mycroft, remove the potatoes timer Hey Mycroft, kill the turkey timer

Cancel all timers

When no timers are beeping, this command removes all timers from the list. If any timers are beeping, this command stops all of the beeping timers.

Hey Mycroft, cancel all timers Hey Mycroft, delete all timers

Mute timer

Muting stops the beep but leaves the timer in the list so that expired timers can be displayed.

Hey Mycroft, mute the timer Hey Mycroft, silence the timer

Version Checker

Check the version of the software. If an update exists, Mycroft will ask if the User wishes to update. To keep up-to-date, Mycroft automatically performs these checks on a daily basis.

Query the Mycroft software version (mycroft-core)

Hey Mycroft, check version Hey Mycroft, what is code?

Query the platform (e.g. Picroft, Mark 1) build version

Hey Mycroft, find platform version Hey Mycroft, what is platform build?

Volume

Manages Mycroft's volume level.

Query volume level

Hey Mycroft, what is the volume? Hey Mycroft, how loud?

Set volume to a numeric level (0 to 10)

In a tribute to Spinal Tap, a level of '11' is accepted (equivalent to level 10).

Hey Mycroft, increase volume to 8 Hey Mycroft, set sound to NORMAL <- - - Keyword options: NORMAL=6, QUIET=3, LOUD=9

Set volume to a percentage (0 to 100%)

Hey Mycroft, set audio to 75 percent Hey Mycroft, decrease volume to 50 percent

Set to maximum volume

Hey Mycroft, crank it all the way up Hey Mycroft, set audio to max

Increase volume by one numeric level

Hey Mycroft, raise the sound Hey Mycroft, make it higher Hey Mycroft, louder

Decrease volume by one numeric level

Hey Mycroft, lower the sound Hey Mycroft, make it quieter Hey Mycroft, softer

Mute

Hey Mycroft, mute the volume Hey Mycroft, silence the audio

Unmute

Hey Mycroft, unmute the speaker Hey Mycroft, restore the sound

Weather

An interface to OpenWeatherMap.org that supports an extensive set of queries.

Hey Mycroft, what is the weather? Hey Mycroft, what is the forecast tomorrow? Hey Mycroft, what is the weather going to be like Tuesday? Hey Mycroft, what is the weather in Houston? Hey Mycroft, when will it rain next? Hey Mycroft, how windy is it? Hey Mycroft, what's the humidity? Hey Mycroft, is it going to snow? Hey Mycroft, what's the temperature?

Wiki

Interfaces to Wikipedia.org

Query Wikipedia

Hey Mycroft, what does Wikipedia say about chocolate? Hey Mycroft, tell me about artificial intelligence Hey Mycroft, search Grace Hopper

Ask Wikipedia for more details on same subject

Hey Mycroft, tell me more Hey Mycroft, please continue

Let Wikipedia select the subject

Hey Mycroft, teach me something Hey Mycroft, tell me a random thing

The Fallback Handlers

Mycroft has two fallback handlers for the situation where the natural language processing fails to match a specific Intent and Skill; one for queries and one for unknowns.

By default, Mycroft has access to two general purpose search engines: Duck Duck Go and Wolfram Alpha. When the utterance is a query, Mycroft sends it to all of these Common Query search engines simultaneously. The first engine to reply successfully is the search engine selected by Mycroft to reply to the User.

If no search engine provides a successful answer to the query, or if the utterance was not a query, then Mycroft activates the Unknown Handler that responds with a variety of phrases explaining that Mycroft cannot handle the utterance.

Common Query

Sent to all fallback Common Query search engines.

Hey Mycroft, what is Frankenstein? Hey Mycroft, who is Kathryn Johnson? Hey Mycroft, how high is Mount Everest? Hey Mycroft, how many inches in a meter?

Subsequent Commands to a Common Query

A Common Query search engine may optionally support subsequent commands (e.g. "send me details") that are processed if that search engine handled the initial query.

Subsequent commands for Wolfram Alpha:

Have more details of last query emailed to User

Hey Mycroft, send me details on that Hey Mycroft, email sources to me

More information on Skills

For more information on Skills, please see the Skills section