Tessie MCP Server
A Model Context Protocol (MCP) server that wraps the Tessie API so LLM clients (Cursor, Claude, etc.) can query and control a configured Tesla using efficient, focused API endpoints.
Status
- Telemetry: Fully implemented with both legacy (full state) and new specialized endpoints for efficient data retrieval.
- Control:
honk_hornandflash_lightsare live and functional. Lock/unlock and climate control are scaffolded. - Breaking change: Now uses VIN instead of license plate for vehicle identification.
- Breaking changes are possible until the first stable tag is cut.
Quick Start
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
# Configure environment
cp .env.example .env
Edit .env and set your Tessie API token and vehicle VIN:
TESSIE_TOKEN=your_tessie_api_token_here
VEHICLE_VIN=5YJ3E1EA1KF123456 # Your Tesla VIN
TELEMETRY_INTERVAL=5 # minutes; use 'realtime' to skip caching
Run the server (STDIO by default):
python -m src.server
Remote/SSE mode (for network clients):
python -m src.server --transport sse --host 0.0.0.0 --port 8000
What To Expect
- New Specialized Telemetry Endpoints: Efficient, focused API calls for battery, battery health, location, tire pressure, and vehicle status.
- Legacy Telemetry Tools: Full vehicle state fetch with all traditional metrics still available.
- Working Control Actions:
honk_hornandflash_lightsexecute real commands on your Tesla. - Tessie-backed auth and caching; respects refresh intervals from
.env. - VIN-based vehicle identification for improved reliability.
Repo Layout
src/server.py— MCP entrypoint; loads telemetry + control tools, handles VIN configuration.src/telemetry/service.py— Telemetry retrieval with caching and specialized endpoint methods.src/telemetry/tools.py— Telemetry tool registry/dispatch (new + legacy tools).src/control/service.py— Control actions with real implementations for honk/flash.src/control/tools.py— Control tool registry/dispatch.src/tessie_client.py— Tessie REST client with VIN-based endpoints for telemetry and control.
Available Tools
New Specialized Telemetry (Recommended)
get_battery_information— Battery level, drain, energy, voltage, current, temperatureget_battery_health_information— Battery capacity and max rangeget_location_information— GPS coordinates with addressget_tire_pressure_information— All tire pressures with statusget_vehicle_status— Sleep/wake status
Control (Live)
honk_horn— Honk the vehicle horn (⚠️ real action)flash_lights— Flash the vehicle lights (⚠️ real action)
Roadmap
- Complete lock/unlock door control
- Implement climate control (start/stop)
- Add charging control
- Trunk/frunk control
See AGENTS.md for complete tool documentation.