My T is an independent iPhone client for viewing and understanding data from your own TeslaMate server.
Download My T on the App Store · Setup guide · Support · Privacy
Feature availability: the public App Store build is My T 3.10 (no Companion screens). TestFlight / pre-release My T 3.20+ supports My T Companion 1.10.0 (parking timeline, observed events, trajectories, optional Live Activities after pairing). See feature availability.
This repository contains public product documentation and support material. It does not contain the My T application source code.
TeslaMate is the foundation of the self-hosted My T experience. It runs on the user's own server, connects to the vehicle, records states, drives, charging sessions, positions, and efficiency data, and keeps that history in the user's PostgreSQL database.
My T turns that TeslaMate history into an iPhone experience with an overview, searchable trips, charging analysis, daily timelines, maps, and route replay. It does not replace TeslaMate, operate a separate Tesla account connection, or move the user's TeslaMate history into a My T cloud.
The three projects have different roles:
| Component | Role |
|---|---|
| TeslaMate | Primary self-hosted data collector and source of truth |
| TeslaMateAPI | JSON bridge used by My T to read normal TeslaMate data |
| My T Companion | Optional read-only enhancement for parking history, verified drive trajectories, charging/navigation Live Activities, and vehicle software notifications |
New users should deploy and verify TeslaMate first by following its official documentation, then add TeslaMateAPI, connect My T, and only afterward consider the optional My T Companion.
- Presents vehicle status, battery, rated range, location, and parking duration.
- Organizes drives into searchable history, statistics, daily timelines, and animated route replay.
- Shows charging sessions, energy, cost, charging curves, and related trends.
- Supports live vehicle location and genuine active-drive data when the server has recorded it.
- Supports multiple self-hosted TeslaMate connections and multiple vehicles.
- Also supports Tessie as a separate optional data source.
- Stores connection credentials in the iOS Keychain.
With the optional My T Companion, the parking monitor retains genuine observations that a suspended iPhone cannot collect continuously:
- online, offline, sleep, wake, and charging transitions in chronological order;
- battery percentage and rated range at each boundary when TeslaMate reported them;
- cable connected/disconnected and charging started/stopped;
- lock/unlock, doors, windows, front/rear trunks, and charge-port changes;
- Sentry, climate, preconditioning, and battery-heating changes.
The first retained MQTT value after install/restart is a baseline, not an invented event. Missing battery, range, or event data remains unavailable instead of being estimated. Parking events are retained long-term by default with a bounded capacity policy. Standard parking, trip, and charging history continues to work without Companion.
Vehicle → TeslaMate → PostgreSQL
│
├─ TeslaMateAPI → My T
│
└─ My T Companion (optional, read-only) → My T
Normal vehicle, drive, charge, and statistics data is read through TeslaMateAPI. My T may optionally read the TeslaMate web endpoint to display server-version information; that endpoint is not required for normal vehicle data.
My T Companion 1.10.0 is an optional server component for genuine long-term parking sleep/wake history, battery and rated-range observations at state boundaries, retained plug/charging/security/climate events, reliable current-drive trajectories, and optional charging/navigation Live Activities or software notifications while the App is not open (after secure pairing). Basic My T features continue to work without it.
Screenshots use demonstration data and do not show a real user's vehicle location, VIN, server address, or credentials.
- iPhone with iOS 18 or later.
- Either a working self-hosted TeslaMate deployment with a compatible TeslaMateAPI, or a supported Tessie connection.
- A safe path from the iPhone to the API: trusted LAN, VPN/Tailscale, or HTTPS with authentication.
My T currently validates against TeslaMateAPI 1.25.0. Compatibility can
change as upstream projects evolve; see the dated
compatibility notes before changing server versions.
- Deploy and verify TeslaMate by following the official TeslaMate documentation.
- Add and secure TeslaMateAPI.
- In My T, open Settings → Server Connections → TeslaMate Server.
- Enter the API root URL and the matching authentication method.
- Run Test Connection and select a vehicle.
- Optionally deploy My T Companion after the normal connection works.
Never expose TeslaMate, PostgreSQL, MQTT, Grafana, or an unauthenticated API directly to the Internet. See the complete setup guide.
My T has no developer-operated vehicle database. Vehicle history remains on the server or provider selected by the user. The app reads it directly from that configured service. See PRIVACY.md for the important distinction between vehicle data and optional iCloud configuration sync.
My T is an independent third-party application. It is not affiliated with, endorsed by, or supported by Tesla, Inc., the TeslaMate project, or the TeslaMateAPI project. Tesla, TeslaMate, and other names and marks belong to their respective owners.
- App source code, signing material, internal build files, and private infrastructure are intentionally excluded.
- Do not post API tokens, passwords, Cloudflare secrets, VINs, coordinates,
.envfiles, raw logs, or database exports in public issues. - Security reports must follow SECURITY.md.
- Documentation contributions should follow CONTRIBUTING.md.
Copyright © 2026 My T. Documentation and product assets are provided under the terms in LICENSE.md.