GithubHelp home page GithubHelp logo

homebridge-nest's Introduction


Nest plugin for HomeBridge

This repository contains the Nest plugin for homebridge that was previously bundled in the main homebridge repository.


  1. Install homebridge using: npm install -g homebridge
  2. Install this plugin using: npm install -g homebridge-nest
  3. Update your configuration file. See sample-config.json snippet below.

It is Strongly advised that you switch to the new API but it is not required at the moment. It will fall back to the old API, but no new development will be done on the old API.

Until an alternative is determined (like Nest Weave which hasn't been released yet or setting up a website for generating tokens specifically for HomeBridge-Nest), you will have to setup an developer account for Nest. Its a simple process and if you specify that it is for Individual, then you are auto approved (at least in my experience).

WARNING: Switching to the new API means it will show up as brand new device. This is due to the fact that the unofficial API used a different device id and we have no way to link it to the official cloud device id. This means any configurations, alarms, scenes, etc to which the Nest was associated will have need to be updated with the new Nest device.

Note: The name of the device will change as well. It matches the name displayed in the Nest app. In my case, I originally configured the Nest app so the the "Where" of my Nest was "Hallway" and I also added a label which was "Nest", so the display was "Hallway (Nest)". To fix the name to say "Nest", you can use the Nest app and blank out the "Label" and use the custom "Where" of "Nest". Anther option to fix the name is through HomeKit. HomeKit allows you to rename Accessories and Services, but it requires an app like Insteon+ that has the ability to change the name.

How to Setup New API

  1. Go to
  2. Choose Sign In
  3. Use your normal account to sign in
  4. Fill in you info in 'Step 1'
  5. In 'Step 2' set:
  6. Then just agree to the terms and submit
  7. Go to Products and create a new product
  8. Fill in:
    • Product Name: HomeBridge + your name (must be unique)
    • Description: Open source project to provide HomeKit integration
    • Categories: Home Automation
    • Users: Individual
    • Support URL:
    • Redirect URL: [LEAVE BLANK]
    • Permissions (minimum):
      • Enable Thermostat with read/write v4
      • Enable Away with read/write v2
      • Enable Smoke+CO alarm with read v4 (if you ever might want Nest Protect)
      • Enable Camera with read v2 (if you ever might want Nest Cam, motion detection only)
      • Permission description: fill in anything
  9. Now you should have a product. Now locate the id/secret section on the right of your product's page
  10. Copy the Product ID to your HomeBridge config as the clientId in the Nest config
  11. Copy the Product Secret to your HomeBridge config as the clientSecret in the Nest config
  12. Navigate to the Authorization URL
  13. Accept the terms and copy the Pin Code to your HomeBridge config as the code in the Nest config
  14. Run HomeBridge once (do not include the token in the config at this time) and you should find a log that says something like "CODE IS ONLY VALID ONCE! Update config to use {'token':'c.5ABsTpo88k5yfNIxZlh...'} instead." Copy the c.5ABsTpo88k5yfNIxZlh... portion to your HomeBridge config as the token in the Nest config
  15. You should be able to restart HomeBridge and it should succeed with the new token.

After that you will be FINALLY done (Huzzah!). If the token is working correctly, you no longer NEED the other three configs (clientId, clientSecret, and code) nor the original username and password from the legacy system (but you can keep them around if you wish, they will be ignored).


Configuration sample:

"platforms": [
   		"platform": "Nest",
   		"token" : "token will be generated upon first run of homebridge without a token",
   		"clientId": "developer Product ID",
   		"clientSecret": "developer Product Secret.",
   		"code": "your Pincode from Nest",


  • "platform": Must always be "Nest" (required)

  • "token": The only (and final) authentication piece you need to use the new API (required for new api, after determined)

  • "clientId": Can be anything (required for new api, if token not yet determined)

  • "clientSecret": Can be anything (required for new api, if token not yet determined)

  • "code": Can be anything (required for new api if trying to determine token)

homebridge-nest's People


alguevara7 avatar alistairg avatar bearmarch avatar ethansinjin avatar fcarucci avatar kraigm avatar masonjames avatar mrose17 avatar mschmidt avatar nfarina avatar pedroserano avatar philfreo avatar redec avatar schmittx avatar spacecowgirl314 avatar stemwinder avatar yungsters avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.