---
id: teslajsonpy
version: "3.13.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# teslajsonpy — A library to work with Tesla API.

License: permissive · Maintenance: active · Downloads: 89.0K/mo

## What it is and what it does

teslajsonpy is an async Python wrapper around the Tesla API, built to enable Home Assistant and other home automation platforms to control and monitor Tesla vehicles. It abstracts the HTTP communication layer, handling authentication, request formatting, and response parsing so that integrations can work with Tesla vehicles without reimplementing API details. The library depends on aiohttp for async HTTP, tenacity for retry logic, beautifulsoup4 for parsing, and several other utilities for authentication and JSON handling.

The package is in Alpha status but actively maintained, with support across Python 3.7–3.13. It carries no known security vulnerabilities and is permissively licensed under Apache-2.0. It is primarily used by Home Assistant users and developers building Tesla integrations, though the exact scope of real-world adoption beyond that ecosystem is not documented in the fact sheet.

Use it for:

- Build Home Assistant automations that lock/unlock Tesla vehicles, control climate, or trigger charging.
- Monitor Tesla vehicle state (battery, location, temperature) from a custom Python application.
- Integrate Tesla vehicle data into a home automation dashboard or notification system.
- Develop a third-party tool that queries Tesla API without reimplementing authentication and request handling.
- Create scheduled tasks to check vehicle status or perform maintenance checks via async Python.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

An async Python library for interacting with the Tesla API, designed to enable integration with Home Assistant and other automation platforms.

Yes, if you are building a Home Assistant integration or custom automation around Tesla vehicles. The library is actively maintained, has low install friction, carries no known vulnerabilities, and is permissively licensed. The Alpha status and modest GitHub presence (58 stars) suggest it is stable enough for its primary use case but not yet a de facto standard; verify that the API surface matches your integration needs before committing.

## Install

pip install teslajsonpy
uv add teslajsonpy
poetry add teslajsonpy

## Installing teslajsonpy

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent commit on 2026-08-10 and a release from 2025-09-26. Supports Python 3.7 through 3.13.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with attribution. Contributions are accepted under the same license.

Quickstart:

pip install teslajsonpy

import asyncio
from teslajsonpy import TeslaAPI

async def main():
    api = TeslaAPI(email, password)
    vehicles = await api.list_vehicles()

asyncio.run(main())

Requires Python 3.7 or later and async/await support; Tesla account credentials needed for API access.

Verify before relying:

- Whether the package handles Tesla API authentication changes or rate limiting transparently.
- Current status of Home Assistant integration—whether it remains the primary use case or if broader adoption has emerged.
- Whether authcaptureproxy dependency is required for CAPTCHA handling in all scenarios or only specific auth flows.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 89.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tesla api python async, tesla home automation library, tesla vehicle control python, async tesla api client, tesla home assistant integration, tesla json api wrapper, tesla vehicle data access, tesla-api, home-automation, async-http

[View on SkillFed](https://skillfed.io/packages/teslajsonpy) · [View on PyPI](https://pypi.org/project/teslajsonpy/)