tesla-fleet-api

How to use

Copy the installation command and review the source package before installing it in your own agent environment.
Check the source document for required tools, credentials and supported hosts.
Describe your input and desired deliverable; review the output against the source material.

npx skills add https://github.com/odrobnik/tesla-fleet-api-skill --skill tesla-fleet-api

Before you start

Installation does not include a model subscription, API allowance or permission to access your files.
Repository stars and installation counts describe activity, not an independent quality or security test.

Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Tesla Fleet API

Control Tesla vehicles via the official Fleet API.

Scripts Overview

Script	Purpose
`command.py`	Vehicle commands (climate, charging, locks, etc.)
`vehicle_data.py`	Read vehicle data (battery, climate, location, etc.)
`vehicles.py`	List vehicles + refresh cache
`auth.py`	Authentication and configuration
`tesla_oauth_local.py`	OAuth helper with local callback server
`start_proxy.sh`	Start the signing proxy (for vehicle commands)
`stop_proxy.sh`	Stop the signing proxy

Setup / Configuration

Setup is documented in `SETUP.md`:

SETUP.md

State directory: {workspace}/tesla-fleet-api/

config.json (provider creds + non-token config)
auth.json (tokens)
vehicles.json (cached vehicle list)
places.json (named locations)
proxy/ (TLS material for signing proxy)

No .env file loading — credentials in config.json or environment variables.

command.py - Vehicle Commands

Execute commands on your Tesla. Vehicle is auto-selected if you only have one.

Usage

bash

command.py [VEHICLE] <command> [options]

VEHICLE - Vehicle name or VIN (optional if single vehicle)
Commands can be run without specifying vehicle: command.py honk
Or with vehicle name: command.py flash honk (vehicle "flash", command "honk")

Climate Control

Start/Stop Climate

bash

command.py climate start
command.py climate stop
command.py flash climate start          # specific vehicle

Set Temperature

bash

command.py climate temps <driver_temp> [passenger_temp]
command.py climate temps 21             # both seats 21°C
command.py climate temps 22 20          # driver 22°C, passenger 20°C

Climate Keeper Mode

bash

command.py climate keeper <mode>

Modes: off, keep, dog, camp

Seat Heater

bash

command.py seat-heater --level <level> [--position <position>]
command.py seat-heater -l <level> [-p <position>]

Levels:

Value	Name
0	off
1	low
2	medium
3	high

Positions:

Value	Names
0	`driver`, `front_left`, `fl`
1	`passenger`, `front_right`, `fr`
2	`rear_left`, `rl`
3	`rear_left_back`
4	`rear_center`, `rc`
5	`rear_right`, `rr`
6	`rear_right_back`
7	`third_left`
8	`third_right`

Examples:

bash

command.py seat-heater -l high                    # driver (default)
command.py seat-heater -l medium -p passenger
command.py seat-heater --level low --position rear_left
command.py seat-heater -l 2 -p 4                  # medium, rear center
command.py seat-heater -l off -p driver           # turn off

Seat Cooler (Ventilation)

bash

command.py seat-cooler --level <level> [--position <position>]
command.py seat-cooler -l <level> [-p <position>]

Same levels and positions as seat heater.

Examples:

bash

command.py seat-cooler -l medium -p driver
command.py seat-cooler -l high -p passenger

Seat Auto Climate

bash

command.py seat-climate [--position <position>] <mode>
command.py seat-climate [-p <position>] <mode>

Modes: auto, on, off

Examples:

bash

command.py seat-climate auto                      # driver auto
command.py seat-climate -p passenger auto
command.py seat-climate -p driver off             # disable auto

Steering Wheel Heater

bash

command.py steering-heater <on|off>

Examples:

bash

command.py steering-heater on
command.py steering-heater off

Precondition Schedules

Modern API for scheduling departure preconditioning (replaces deprecated set_scheduled_departure).

Add Schedule

bash

command.py precondition add --time <HH:MM> [--days <days>] [--id <id>] [--one-time] [--disabled]
command.py precondition add -t <HH:MM> [-d <days>] [--id <id>]

Days options:

Value	Description
`all`	Every day (default)
`weekdays`	Monday through Friday
`weekends`	Saturday and Sunday
`mon,tue,wed,...`	Specific days (comma-separated)

Day names: sun, mon, tue, wed, thu, fri, sat (or full names)

Examples:

bash

command.py precondition add -t 08:00              # every day at 8am
command.py precondition add -t 08:00 -d weekdays  # Mon-Fri
command.py precondition add -t 07:30 -d mon,wed,fri
command.py precondition add -t 09:00 --one-time   # one-time only
command.py precondition add -t 08:30 --id 123     # modify existing schedule
command.py precondition add -t 08:00 --disabled   # create but disabled

Remove Schedule

bash

command.py precondition remove --id <id>

Examples:

bash

command.py precondition remove --id 123
command.py precondition remove --id 1

Charging Control

Start/Stop Charging

bash

command.py charge start
command.py charge stop

Set Charge Limit

bash

command.py charge limit <percent>

Percent must be 50-100.

Examples:

bash

command.py charge limit 80
command.py charge limit 90
command.py flash charge limit 70                  # specific vehicle

Doors & Security

bash

command.py lock                   # lock all doors
command.py unlock                 # unlock all doors
command.py honk                   # honk the horn
command.py flash                  # flash the lights
command.py wake                   # wake vehicle from sleep

With vehicle name:

bash

command.py flash wake             # wake vehicle named "flash"
command.py flash flash            # flash lights on vehicle "flash"

vehicle_data.py - Read Vehicle Data

Fetch vehicle data with human-readable output by default.

Usage

bash

vehicle_data.py [VEHICLE] [flags] [--json]

VEHICLE - Vehicle name or VIN (optional if single vehicle)
No flags = all data
--json = raw JSON output

Flags

Flag	Long	Data
`-c`	`--charge`	Battery level, charge limit, charging status
`-t`	`--climate`	Interior/exterior temp, HVAC status
`-d`	`--drive`	Gear, speed, power, heading
`-l`	`--location`	GPS coordinates
`-s`	`--state`	Locks, doors, windows, odometer, software
`-g`	`--gui`	GUI settings (units, 24h time)
	`--config-data`	Vehicle config (model, color, wheels)

Examples

bash

# All data
vehicle_data.py
vehicle_data.py flash

# Specific data
vehicle_data.py -c                        # charge only
vehicle_data.py -c -t                     # charge + climate
vehicle_data.py flash -c -l               # charge + location

# Raw JSON
vehicle_data.py --json
vehicle_data.py -c --json

Sample Output

🚗 My Tesla (online)
   VIN: 5YJ... (redacted)

⚡ Charge State
────────────────────────────────────────
  Battery:    [███████████████░░░░░] 78%
  Limit:      80%
  State:      Charging
  Power:      11 kW (16A × 234V × 3φ)
  Added:      37.2 kWh
  Remaining:  10m
  Range:      438 km (272 mi)
  Cable:      IEC

🌡️  Climate State
────────────────────────────────────────
  Inside:     11.9°C
  Outside:    6.0°C
  Set to:     20.5°C
  Climate:    Off

auth.py - Authentication

Manage OAuth tokens and configuration.

Usage

bash

auth.py <command> [options]

Commands

Login (OAuth Flow)

bash

auth.py login

Interactive: generates auth URL, prompts for code, exchanges for tokens.

Exchange Code

bash

auth.py exchange <code>

Exchange authorization code for tokens (non-interactive).

Refresh Tokens

bash

auth.py refresh

Refresh access token. Note: refresh tokens rotate - the new one is saved automatically.

Register Domain

bash

auth.py register --domain <domain>

After registration, enroll your virtual key:

https://tesla.com/_ak/<domain>

Show Config

bash

auth.py config

Display current configuration (secrets redacted).

Set Config

bash

auth.py config set [options]

Options:

--client-id <id>
--client-secret <secret>
--redirect-uri <uri>
--audience <url>
--base-url <url>
--ca-cert <path>
--domain <domain>

Examples:

bash

# Initial setup
auth.py config set \
  --client-id "abc123" \
  --client-secret "secret" \
  --redirect-uri "http://localhost:18080/callback"

# Configure proxy
auth.py config set \
  --base-url "https://localhost:4443" \
  --ca-cert "/path/to/tls-cert.pem"

tesla_fleet.py - List Vehicles

List vehicles with human-readable output.

bash

python3 scripts/tesla_fleet.py vehicles
python3 scripts/tesla_fleet.py vehicles --json

Sample Output

🚗 Name:   My Tesla
🔖 VIN:    5YJ... (redacted)
🟢 Status: Online
👤 Access: Owner

Configuration / Proxy / File layout

All setup + configuration is documented in [SETUP.md](SETUP.md).

Regional Base URLs

Region	Audience URL
Europe	`https://fleet-api.prd.eu.vn.cloud.tesla.com`
North America	`https://fleet-api.prd.na.vn.cloud.tesla.com`
China	`https://fleet-api.prd.cn.vn.cloud.tesla.cn`

OAuth token endpoint (all regions):

https://fleet-auth.prd.vn.cloud.tesla.com/oauth2/v3/token

Troubleshooting

"vehicle unavailable: vehicle is offline or asleep"

Wake the vehicle first:

bash

command.py wake

"command not signed" / "vehicle rejected"

Ensure the signing proxy is running and configured. See SETUP.md § Proxy Setup.

Token expired

bash

auth.py refresh

Multiple vehicles

Specify vehicle by name or VIN:

bash

command.py flash climate start
command.py 5YJ... honk

Complete Command Reference

command.py

climate start|stop
climate temps <driver> [passenger]
climate keeper off|keep|dog|camp

seat-heater -l <level> [-p <position>]
seat-cooler -l <level> [-p <position>]
seat-climate [-p <position>] auto|on|off

steering-heater on|off

precondition add -t <HH:MM> [-d <days>] [--id <id>] [--one-time]
precondition remove --id <id>

charge start|stop
charge limit <percent>

lock
unlock
honk
flash
wake

vehicle_data.py

[VEHICLE] [-c] [-t] [-d] [-l] [-s] [-g] [--config-data] [--json]

auth.py

login
exchange <code>
refresh
register --domain <domain>
config
config set [--client-id] [--client-secret] [--redirect-uri] [--audience] [--base-url] [--ca-cert] [--domain]

How to use

Before you start

Tesla Fleet API

Scripts Overview

Setup / Configuration

command.py - Vehicle Commands

Usage

Climate Control

Start/Stop Climate

Set Temperature

Climate Keeper Mode

Seat Heater

Seat Cooler (Ventilation)

Seat Auto Climate

Steering Wheel Heater

Precondition Schedules

Add Schedule

Remove Schedule

Charging Control

Start/Stop Charging

Set Charge Limit

Doors & Security

vehicle_data.py - Read Vehicle Data

Usage

Flags

Examples

Sample Output

auth.py - Authentication

Usage

Commands

Login (OAuth Flow)

Exchange Code

Refresh Tokens

Register Domain

Show Config

Set Config

tesla_fleet.py - List Vehicles

Sample Output

Configuration / Proxy / File layout

Regional Base URLs

Troubleshooting

"vehicle unavailable: vehicle is offline or asleep"

"command not signed" / "vehicle rejected"

Token expired

Multiple vehicles

Complete Command Reference

command.py

vehicle_data.py

auth.py

Related by task

setup-matt-pocock-skills

backend-patterns

wizard

ecc-guide