🚗 Tessie MCP Server - Tesla Intelligence Platform

🚗 The most advanced Tesla MCP server available - Transform your Tesla ownership with intelligent analytics, cost optimization, and predictive insights through the Tessie API. From smart charging reminders to efficiency trends analysis, get the intelligence you need to optimize every aspect of your Tesla experience.

🆕 What's New in v1.2.0

• 📊 Efficiency Trends Analysis - Weekly/monthly/seasonal efficiency tracking with weather & speed impact

• 🔌 Smart Charging Reminders - Intelligent charging optimization with time-of-use cost savings

• 🛡️ Enhanced Error Handling - Robust retry logic with graceful degradation for vehicle sleep/offline states

• ⚡ Improved FSD Detection - Removed reliance on broken autopilot_distance API field

• 🎯 Production Ready - Comprehensive error classification with user-friendly messages

✨ Key Features

💰 Financial Intelligence

• Smart Charging Cost Analysis - Track home vs Supercharger vs public charging costs

• Trip Cost Optimization - Calculate real trip costs with gas vehicle comparisons

• Money-Saving Recommendations - "Shift to off-peak charging to save $45/month"

• Environmental Impact Tracking - CO2 savings and tree-planting equivalents

🧠 Predictive Analytics

• Commute Pattern Detection - Auto-identify regular routes (home ↔ work)

• Efficiency Trend Analysis - Track route performance over time

• FSD Usage Estimation - Predict autopilot usage from driving patterns

• Future Trip Planning - Cost estimates and charging strategy for upcoming trips

📊 Advanced Insights

• Efficiency Trends - Weekly/monthly/seasonal efficiency analysis with confidence scoring

• Weather Impact Analysis - Hot/cold weather penalties with optimization tips

• Speed Factor Analysis - Highway vs city efficiency with optimal speed recommendations

• Smart Charging Reminders - Priority-based alerts with cost savings calculations

• Time Pattern Detection - Best/worst days and times for efficient driving

• Route Optimization - "Your Santa Rosa commute efficiency is declining 📉"

• Charging Strategy - Optimal departure battery levels and time-of-use scheduling

• Weekly/Monthly Summaries - Comprehensive ownership analytics with actionable insights

🚗 Complete Tesla Data Access

• Real-time Vehicle State - Battery, location, climate, locks, speed

• Historical Driving Data - Trips, mileage, efficiency, routes

• Charging Analytics - Sessions, costs, locations, optimization

• Smart VIN Resolution - Automatically detects your active vehicle

🛡️ Production-Ready Reliability

• Intelligent Error Handling - Automatic retry with exponential backoff

• Graceful Degradation - Fallback responses when vehicle is asleep/offline

• Rate Limit Respect - Smart handling of Tessie API limits with retry-after

• Network Resilience - Robust handling of timeouts and connectivity issues

• User-Friendly Errors - Clear explanations with actionable troubleshooting tips

• Context-Aware Responses - Different retry strategies for real-time vs historical data

Installation

Choose your preferred installation method:

Option 1: Via Smithery (Universal - Recommended)

Install automatically via Smithery:

This method works with any MCP-compatible client and handles updates automatically.

Option 2: MCPB Package (For MCP Clients)

1. Download the latest tessie-mcp-v*.mcpb file from the GitHub releases page

2. Double-click the .mcpb file to install it in your MCP client

3. Enable the extension in your client settings

4. Configure your Tessie API token when prompted

Prerequisites

• MCP-compatible client (Claude Desktop v0.10.0+, or any MCP client)

• Tessie account with API access from tessie.com

• Node.js v18.0.0 or later (for local development)

Configuration

The server requires your Tessie API token to function:

1. Log into your Tessie account at https://tessie.com

2. Navigate to your API settings

3. Copy your API token

4. Configure it in your MCP client when prompted

Upgrading

• Smithery: Run the install command again to upgrade

• MCPB: Download and install the new .mcpb file (auto-replaces old version)

🛠️ Available Tools

🚗 Vehicle Information & Status

• get_vehicles - List all vehicles in your Tessie account

• get_vehicle_current_state - Get comprehensive vehicle status with location address

• get_driving_history - Get driving history and trip data

• get_weekly_mileage - Calculate total miles driven in a specific period

💰 Financial & Cost Analysis

• analyze_charging_costs - Comprehensive charging cost analysis by location type

• calculate_trip_cost - Calculate cost and environmental impact of completed trips

• estimate_future_trip - Plan charging strategy and costs for upcoming trips

🧠 Intelligence & Analytics

• analyze_latest_drive - Detailed analysis of recent drive with FSD prediction

• analyze_commute_patterns - Detect regular routes with efficiency trends

• analyze_efficiency_trends - Comprehensive efficiency analysis with weather/speed/time factors

• get_smart_charging_reminders - Intelligent charging optimization with cost savings

• natural_language_query - Process natural language queries about vehicle data

🔋 Battery & Charging

• Smart charging cost tracking with home vs Supercharger vs public analysis

• Money-saving recommendations based on usage patterns

• Time-of-use optimization for peak/off-peak charging rates

📍 Location & Navigation

• Automatic address resolution from GPS coordinates

• Route pattern recognition for commute detection

• Distance and efficiency calculations between locations

🤖 Predictive FSD Detection

• Highway speed consistency analysis for autopilot estimation

• Route-based FSD probability using driving patterns

• Efficiency comparison between predicted FSD and manual driving

💬 Example Commands

🚗 Vehicle Status & Location

💰 Cost Analysis & Optimization

🗺️ Trip Planning & Analysis

🛣️ Commute & Route Intelligence

🤖 FSD & Autopilot Analysis

📊 Advanced Analytics & Efficiency

🔌 Smart Charging & Optimization

📊 Comprehensive Analytics

Your MCP client will automatically use the appropriate Tessie tools to get the information you need.

Smart VIN Resolution

The server automatically handles vehicle identification:

• Single Active Vehicle: If you have one active Tesla, it's used automatically

• Multiple Vehicles: If you have multiple active vehicles, you'll be prompted to choose

• No Active Vehicles: Clear error messages if no vehicles are available

Experimental FSD Detection

⚠️ Important Disclaimer: The FSD detection feature is experimental and provides estimates only. It is not verified by Tesla or Tessie and should not be considered accurate for official purposes.

How It Works

The server analyzes driving patterns to estimate when Full Self-Driving might have been active:

• Speed Consistency: FSD maintains very consistent speeds, especially on highways

• Heading Smoothness: FSD produces smooth, predictable steering patterns

• Route Characteristics: FSD is more commonly used on highways and longer trips

• Duration Analysis: FSD usage typically correlates with longer drive segments

Confidence Scoring

Each analysis receives a confidence score (0-100%):

• 80-100: Very High - Strong FSD-like patterns detected

• 60-79: High - Likely FSD usage based on multiple indicators

• 40-59: Moderate - Mixed signals, uncertain

• 20-39: Low - Likely manual driving

• 0-19: Very Low - Manual driving patterns

Limitations

• No Ground Truth: Tesla doesn't provide official FSD usage data

• Pattern-Based Only: Analysis relies on driving patterns, not direct FSD status

• Individual Variation: Driving styles vary; what looks like FSD for one person might be manual for another

• External Factors: Weather, traffic, and road conditions can affect patterns

• Experimental Feature: This is a research tool, not a definitive measurement

Use FSD detection results for personal analysis and insights, but don't rely on them for anything requiring precision.

API Coverage

This server implements all GET endpoints under "Vehicle Data" from the official Tessie API documentation:

• All vehicle information endpoints

• Complete battery and charging data

• Full location and driving history

• Climate and weather information

• Vehicle configuration and settings

• Service and alert data

• Tire pressure and consumption metrics

Security

• API tokens are stored securely in your MCP client's configuration

• No hardcoded credentials in the server code

• All API communication uses HTTPS

• Tokens are passed via environment variables

Requirements

• Node.js: v18.0.0 or later

• MCP Client: Any compatible client (Claude Desktop v0.10.0+, etc.)

• Platforms: macOS, Windows, Linux

• Tessie Account: Active subscription with API access

Troubleshooting

Server Not Running

• Check that you've enabled the server in your MCP client settings

• Verify your Tessie API token is correctly configured

• Try disabling and re-enabling the server

API Errors

• Ensure your Tessie API token is valid and hasn't expired

• Check that your Tesla is connected to Tessie

• Verify your Tesla is awake (some operations require the vehicle to be active)

No Vehicles Found

• Make sure your Tesla is linked to your Tessie account

• Check that the vehicle status shows as "active" in Tessie

• Try refreshing your vehicle connection in Tessie

Development

The server is built as a Node.js MCP (Model Context Protocol) server with:

• TessieClient: Handles all API communication with Tessie

• TessieMCPServer: Implements the MCP protocol for universal client compatibility

• Smart Error Handling: Comprehensive error messages and fallbacks

• Zero Dependencies: No external npm packages required

License

MIT License - see LICENSE file for details.

Support

For issues with the server:

1. Check the troubleshooting section above

2. Verify your Tessie account and API token

3. Check your MCP client logs for detailed error messages

For Tessie API questions, visit the official Tessie documentation.

Note: This server requires a Tessie account and active API access. Tessie is a third-party service that provides enhanced Tesla vehicle data access. Visit tessie.com to learn more.