analytics

Tesla Plugin for Claude Code

Control your Tesla from Claude Code -- natural language vehicle management, charging analytics, order tracking, and a self-hosted web dashboard.

You: "how's my battery?"
Claude: Your Model Y is at 78%, plugged in at home charging at 11 kW.
        Estimated 1h 12m to reach your 80% limit.

You: "turn on the AC and set to 21"
Claude: I'll turn on climate and set the temperature. Can you confirm? (unlock/climate/trunk commands always require your OK)
You: "yes"
Claude: Done -- HVAC is on, target 21 C. Interior is currently 34 C, should cool down in ~10 min.

Install

1. Install the CLI (execution engine)

uv tool install tesla-cli

With optional features:

uv tool install "tesla-cli[serve,teslaMate,fleet,pdf]"

2. Set up your Tesla account

tesla setup

The interactive wizard handles OAuth2 authentication, VIN discovery, backend selection, and first data build.

3. Install the plugin

Step A — Register the Tesla marketplace (once):

claude settings set extraKnownMarketplaces.tesla.source.source git
claude settings set extraKnownMarketplaces.tesla.source.url https://github.com/dacrypt/tesla-claude-plugin.git

Or manually add to ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "tesla": {
      "source": {
        "source": "git",
        "url": "https://github.com/dacrypt/tesla-claude-plugin.git"
      }
    }
  }
}

Step B — Install the plugin in Claude Code:

/plugin install tesla@tesla

Restart Claude Code and the plugin is ready.

4. Use it

Just talk to Claude about your Tesla. Or use slash commands:

/tesla:status           # quick vehicle status
/tesla:control lock     # lock doors (with confirmation)
/tesla:charge weekly    # weekly charging cost summary
/tesla:order status     # delivery tracking
/tesla:dossier build    # vehicle intelligence from 15+ sources
/tesla:analytics trips  # TeslaMate trip history
/tesla:serve            # start web dashboard
/tesla:setup            # first-time onboarding

Skills

Plus a background context skill that auto-loads your vehicle config and charging state.

How it works

You <--chat--> Claude Code
                  |
          tesla-claude-plugin (AI interface)
                  |
              tesla-cli (execution engine)
                  |
        Tesla APIs / TeslaMate / MQTT / HA

The plugin teaches Claude when to run which tesla command and how to interpret the output. All logic lives in the CLI -- the plugin never duplicates it.

Security

• Credentials in system keyring -- never in files, env vars, or skill content
• Zero PII in the plugin -- no VINs, order numbers, or names. Everything resolved at runtime
• Destructive action confirmation -- unlock, trunk, sentry off always require your OK
• 100% local -- no telemetry, no cloud relay, self-hosted
• PII anonymization -- tesla --anon masks sensitive data for screenshots/demos

Requirements

• Python 3.12+
• uv package manager
• Tesla account with at least one vehicle or active order
• Claude Code with plugin support

Optional integrations

License

MIT