v0.133 - Tesla Developer Account required
Starting with evcc v0.133, a Tesla Developer Account is required. The usage remains free of charge, but requires an additional setup step.
8.2.2025: More detailed instructions for the Tesla Fleet API and myteslamate.com configuration.
Paid Tesla Fleet API starting Februaryβ
Last year we integrated the Tesla Fleet API into evcc. Tesla was the first manufacturer to provide an official and above all open API for communication with their vehicles.
Tesla had already announced that this API would not stay free of charge. The prices are now known and will come into effect starting February 1, 2025. The billing is based on usage, with costs varying depending on the type of request.
With tesla.evcc.io we have provided a service that allows evcc users to generate access tokens for API usage. The API communication of these tokens would be billed to us starting February 2025. The costs per user depend on the number of vehicles, charging behavior, and the specific configuration of the update interval. For most users, these costs exceed our "$2 im Monat" sponsoring model and would not be sustainable for us, even if we would require sponsorship for Tesla integration.
Free API credit for private usersβ
Tesla offers private users a monthly API credit of $10, which should be sufficient for most evcc users.
With the version 0.133, we have adapted the API communication to Tesla so that you can use your own Tesla Developer Account. Old tokens generated with tesla.evcc.io will no longer work. We have considered extending our existing token generation process so that you can use your own Tesla Developer Account. Fortunately, myteslamate.com has already implemented this function. There you can generate Access- and Refresh-Tokens with your Developer Account. So we decided not to reinvend the wheel.
What to do?β
For Tesla driversβ
Here is a step-by-step guide to help you set up your Tesla Developer (1) and myteslamate.com (2) account. We recommend to use two browser windows, since both have to be done somewhat in parallel (see skip hints).
- Create a Tesla Fleet API Application
- Log into your Tesla Developer Portal (use your Tesla credentials)
- Click Create New Application and follow the wizard
- Application Details: Pick a name, description and usage you like. (skip to 2.1.)
- Client Details: Fill in the three URLs provided by myteslamate.com
- API/Scope: Select these scopes
- profile information
- vehicle information
- vehicle location (for vehicle detection, not implemented yet)
- vehicle commands (for wakeup)
- vehicle charging management (only for TWC owners, see instructions below)
- Billing Details: Can be skipped
- You'll receive a Client ID and a Client Secret (skip to 2.4.)
- Create a myteslamate.com account
- Visit myteslamate.com
- Select the free Fleet API & Telemetry option
- Sign in with your Tesla account
- Use your personal URLs (Origin, Redirect, Callback) to complete the Tesla Application registration (skip to 1.4.)
- Enter your Client ID and Client Secret
- In the "free and directly" section you will receive your Access- and Refresh-Tokens
- Copy both tokens to your evcc configuration
- Click the Delete these tokens from MyTeslaMate button.
This is important and ensures, that evcc is the only application to use these tokens. Having multiple applications (including myteslamate.com) use the same tokens will lead to token refresh issues.
Example:
vehicles:
- type: template
template: tesla
title: Tesla Model 3
clientId: aaaaaa-11111-... # von developer.tesla.com
accessToken: ey1234567890... # von myteslamate.com
refreshToken: EU_1234567890... # von myteslamate.com
You can also find a more detailed explanation and guide on myteslamate.com.
You can track your used API credit in the Overview of the Tesla Developer Portal.
The evcc project is in no way connected to myteslamate.com. We are in contact with jlestel, the developer of myteslamate.com. The free use of the service for evcc users is explicitly allowed by him. Please refer to the Terms of Service and Privacy Policy before using the service.
For Tesla Wall Connector usersβ
If you use a Tesla Wall Connector, additional steps are required, as the charging commands require signed communication. myteslamate.com offers a "Command Proxy" for 12 β¬ per year, which provides this functionality.
We assume you've already completed the steps described above.
- Log into your myteslamate.com account a second time after you've deleted you tokens (see 2.8.)
- Copy the Proxy-Token from the Use your Tesla API via our proxy section.
- Insert the token into your evcc configuration.
vehicles:
- type: template
template: tesla
title: Tesla Model 3
clientId: aaaaaa-11111-... # von developer.tesla.com
accessToken: ey1234567890... # von myteslamate.com
refreshToken: EU_1234567890... # von myteslamate.com
proxyToken: aaaaa-bbbbb-... # von myteslamate.com
With this setup, evcc will send charging commands to the myteslamate.com proxy, which will sign it with your Tesla application and forward it to the original Tesla API.
The proxy token is very powerful. It is recommended to limit the permissions at myteslamate.com to the necessary functions. For evcc, only the functions Charge Start, Charge Stop and Set Charging Amps are necessary.
Usage dataβ
tesla.evcc.io will be discontinuedβ
tesla.evcc.io will be discontinued in February. All tokens generated with it will lose their validity. For further use of the Tesla API, an update to evcc version 0.133 is required.
Other alternativesβ
The Tesla API communication in evcc is not specific to myteslamate.com. You can generate the tokens with the corresponding infrastructure (public callback URL necessary) yourself and enter them into the evcc configuration mentioned above.
Alternative integrations via services such as TeslaLogger, TeslaMate, TeslaBleHttpProxy, TeslaMate, Tessie or Tronity is also possible.
Tesla Wall Connector owners can also still use TeslaBleHttpProxy as a local "Command Proxy".
Conclusionβ
We have discussed several alternatives for the Tesla integration. Special services and price levels for Tesla users were also on the table. We believe that our current solution from a user's perspective is the best. On the one hand, it does not cause additional costs for most private users. The implementation remains sponsor-free. The API communication does not require third-party services. Users with larger fleets can also use evcc, where the API usage fees directly accrue at Tesla when the monthly free allowance is exceeded.
Best regards
The evcc team
Michael, Andi & Uli