@teslemetry/n8n-nodes-teslemetry

n8n Teslemetry Integration

n8n community nodes for controlling Tesla vehicles and energy sites via the Teslemetry API.

Features

• 🚗 Vehicle Control: Lock/unlock, climate, charging, navigation, and more
• ⚡ Energy Management: Monitor and control Powerwall and Solar systems
• 📡 Real-Time Events: Trigger workflows based on vehicle state changes
• 🔄 Full API Coverage: Access all Teslemetry API features

Installation

Community Nodes Installation (Recommended)

• In your n8n instance, go to Settings → Community Nodes
• Search for @teslemetry/n8n-nodes-teslemetry
• Click Install
• Restart n8n

Manual Installation

npm install @teslemetry/n8n-nodes-teslemetry

For self-hosted n8n instances, you can also install via:

cd ~/.n8n/nodes
npm install @teslemetry/n8n-nodes-teslemetry

Then restart your n8n instance.

Prerequisites

• Teslemetry Account: Sign up at teslemetry.com
• Access Token: Generate an API access token from your Teslemetry dashboard
• Tesla Virtual Key: Configure virtual key access for your vehicle(s)

Configuration

• In n8n, add a new credential of type Teslemetry API
• Enter your Teslemetry access token
• Save the credential

Nodes

Teslemetry Vehicle

Perform operations on your Tesla vehicles.

Operations:

• Get Vehicle Data: Retrieves comprehensive data.
• Wake Up: Wakes up the vehicle.
• Flash Lights: Flashes the headlights.
• Honk Horn: Honks the horn.
• Lock/Unlock Doors: Controls door locks.
• Remote Start: Enables keyless driving.
• Actuate Trunk: Opens/Closes front or rear trunk.
• Climate Control: Start/Stop HVAC, Set Temps, Seat Heaters, Steering Wheel Heater.
• Charging: Start/Stop, Open/Close Port, Set Limit, Set Amps.
• Sentry Mode: Enable/Disable Sentry Mode.
• Homelink: Trigger Homelink.
• Navigation Request: Send a destination to the vehicle navigation.

Teslemetry Energy

Interact with Tesla Energy sites (Solar/Powerwall).

Operations:

• Get Live Status: Live power usage details.
• Get Site Info: Configuration and site details.
• Set Backup Reserve: Set the battery reserve percentage.
• Set Operation Mode: Self Consumption, Backup, or Autonomous.
• Set Storm Mode: Enable/Disable Storm Mode.
• Grid Import/Export: Configure grid export rules.
• Off-Grid Reserve: Set vehicle charging reserve for off-grid operation.

Teslemetry Trigger

Trigger workflows based on real-time vehicle events via Server-Sent Events (SSE).

Event Types:

• All Events: Stream all events
• Data: Real-time telemetry data updates
• State: State changes (online/asleep/charging)
• Vehicle Data: Full vehicle data snapshots
• Errors: Vehicle error events
• Alerts: Vehicle alerts and notifications
• Connectivity: Connection status changes
• Credits: API credit usage updates
• Config: Configuration changes
• Signal: Monitor specific fields (e.g., speed, odometer, battery_level)

Usage Examples

Example 1: Lock Vehicle When Leaving Home

• Add a Teslemetry Vehicle node
• Select your vehicle VIN
• Choose operation: Lock Doors
• Trigger this workflow based on your location or schedule

Example 2: Start Climate Control Before Departure

• Add a Schedule Trigger for your departure time
• Add a Teslemetry Vehicle node
• Select operation: Start HVAC
• Set desired temperatures

Example 3: Monitor Charging Status

• Add a Teslemetry Trigger node
• Set event type to Data
• Filter for charging-related updates
• Send notifications when charging completes

Example 4: Alert on Low Battery

• Add a Teslemetry Trigger node
• Set event type to Signal
• Select signal: battery_level
• Add an IF node to check if battery < 20%
• Send notification via email/SMS

Resources

• Teslemetry Documentation: https://teslemetry.com/docs
• API Reference: https://developer.teslemetry.com
• Support: https://github.com/Teslemetry/typescript-teslemetry/issues

License

Apache-2.0 License - see LICENSE file for details

Contributing

Contributions are welcome! Please see the main repository for contribution guidelines.