Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Control Kwikset Kevo locks

Project description


This is a Python3 fork of the original module for controlling Kwikset Kevo locks written by CSeelye.

Per Cseelye:

Kwikset does not provide an official API for their Kevo locks; I reverse
engineered this module from the web app.

To use this module you will need to have a `Kevo Plus`_ installed and a
registered account on ``_. You will need your
credentials to use this module.

This module is published to `pypi`_ so you can install it simply via ``pip install pykevoplus``


The ``Kevo.GetLocks()`` function will attempt to scrape the web
site to find your locks; as of this writing it can find all of your
locks, but scraping the HTML might break at any time if Kwikset changes
the website.

.. code:: python

from pykevoplus import Kevo
locks = Kevo.GetLocks("", "password123")
for lock in locks:


KevoLock(name=Front Door, id=cca7cd1d-c1d5-43ce-a087-c73b974b3529, state=Locked)
KevoLock(name=Back Door, id=c60130cd-8139-4688-8ba3-199276a65ad6, state=Locked)

A better way is to explicitly instantiate a ``KevoLock`` object using the
UUID of the lock. You can get the lock IDs manually by logging into, click Details for the lock, click Settings, the lock ID is
on the right.

.. code:: python

from pykevoplus import KevoLock
lock = KevoLock.FromLockID("cca7cd1d-c1d5-43ce-a087-c73b974b3529", "", "password123")

Locking and Unlocking

.. code:: python

from pykevoplus import KevoLock
lock = KevoLock.FromLockID(lock_id, username, password)



Multiple operations in the same session

The ``KevoLockSession`` context manager allows you to perform multiple
operations on a lock with a single auth session

.. code:: python

from pykevoplus import KevoLock, KevoLockSession
lock = KevoLock.FromLockID(lock_id, username, password)
with KevoLockSession(lock):

Known Issues

* Error handling is extremely basic and needs much more work. Communication errors as well as lock bolt errors need to be addressed
* Alpha support for Python3

.. _Kevo Plus:
.. _pypi:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pykevocontrol, version 2.0.0
Filename, size File type Python version Upload date Hashes
Filename, size pykevocontrol-2.0.0.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page