Tesla Fleet API

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:

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

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

command.py [VEHICLE]  [options]

Climate Control

#### Start/Stop Climate

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

#### Set Temperature

command.py climate temps  [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

command.py climate keeper 

Seat Heater

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

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:

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)

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

Same levels and positions as seat heater.

Examples:

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

Seat Auto Climate

command.py seat-climate [--position ] 
command.py seat-climate [-p ] 

Modes: auto, on, off

Examples:

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

command.py steering-heater 

Examples:

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

command.py precondition add --time  [--days ] [--id ] [--one-time] [--disabled]
command.py precondition add -t  [-d ] [--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:

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

command.py precondition remove --id 

Examples:

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

Charging Control

#### Start/Stop Charging

command.py charge start
command.py charge stop

#### Set Charge Limit

command.py charge limit 

Percent must be 50-100.

Examples:

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

Doors & Security

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:

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

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

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

# 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

auth.py  [options]

Commands

#### Login (OAuth Flow)

auth.py login

#### Exchange Code

auth.py exchange 

auth.py refresh

auth.py register --domain 

https://tesla.com/_ak/

auth.py config

auth.py config set [options]

# 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"

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

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

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

command.py wake

auth.py refresh

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

climate start|stop
climate temps  [passenger]
climate keeper off|keep|dog|camp
seat-heater -l  [-p ]
seat-cooler -l  [-p ]
seat-climate [-p ] auto|on|off
steering-heater on|off
precondition add -t  [-d ] [--id ] [--one-time]
precondition remove --id 
charge start|stop
charge limit 
lock
unlock
honk
flash
wake

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

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

# 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

"vehicle unavailable: vehicle is offline or asleep"

command.py wake

auth.py refresh

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