by thorpelawrence


alexa-spotify-connect (Connect Control for Spotify)

Greenkeeper badge

Build Status Maintainability Test Coverage Coverage Status

Control Spotify Connect devices with Alexa

Alexa Skill Store


Contribution and development

To get started, fork this repository to make changes. If those changes would be useful in the project, feel free to make a pull request.

Deploy the skill

  1. Create a Spotify developer app at, get a client ID and client secret
  2. Create an Amazon Alexa skill, choosing custom. When you get to the part in the Alexa developer console where you can upload/paste in JSON, run skill/skill.js to generate the JSON required
$ node skill/skill.js
  1. Enter the application ID from the developer console into package.json, under the key alexa.applicationId.
  2. Turn on Account linking, choosing "Auth Code Grant". Set "Authorization URI" to, "Access Token URI" to, set client ID and secret, add scopes user-read-playback-state and user-modify-playback-state, and the three redirect URLs from the account linking details in your developer console for the skill
  3. Deploy this webapp to somewhere that supports HTTPS (required for Alexa skills), for example Heroku
  4. Configure the skill to use an HTTPS endpoint of https://<your-url>/<app-name> where app-name is the name specified in'app-name'), connect by default

Adding a language

  1. Check that the locale is supported by Amazon (see list of supported locale codes) and get your locale code (e.g. en-GB)
  2. Create a locale file in locales/{LOCALE-CODE}.json (see existing locales for formatting), please do not change the placeholder value names (in double curly brackets e.g. {{name}})
  3. Create a localised interaction model used by Skill Builder in skill/locales/{LOCALE-CODE}.json (please only change the values for the samples for each intent and not the intent names or slots). The formatting should be similar to the other locales, but if more (or fewer) samples are required for the language add as many as possible (more samples mean better accuracy) (formatting done by alexa-utterances)
  4. Add the locale to the list of locales in skill/skill-i18n.js (follow the format used by other locales)
  5. Please also provide publishing information as a comment in your pull request so that it can be localised and published to Amazon in the new language
  6. (Optional: for deployment) To create the JSON data required by Skill Builder run
$ node skill/skill-i18n.js





This product is not endorsed, certified or otherwise approved in any way by Spotify. Spotify is the registered trade mark of the Spotify Group.