Tesla MCP Server

A Model Context Protocol (MCP) server that connects to the Tesla Fleet API, allowing you to control your Tesla vehicle using Claude and other AI assistants that support MCP.

Features

• Wake up vehicles: Wake up your Tesla from sleep mode
• Vehicle information: Get detailed information about your Tesla vehicles
• Real-time updates: Refresh vehicle data on demand
• Debugging tools: Access detailed vehicle information to help with troubleshooting

Requirements

• Node.js 18+
• pnpm (preferred) or npm
• Tesla account with at least one vehicle
• Tesla API credentials (Client ID and Client Secret)
• Ngrok (for development and registration)

Security Best Practices

This project handles sensitive Tesla API credentials. Please follow these security practices:

• Never commit credentials: The .gitignore file excludes .env and keys/ but always double-check
• Use the security checker: Run ./check-secrets.sh before committing to detect potentially leaked credentials
• Protect your private keys: Keep the contents of the keys/ directory secure
• Review code before sharing: Make sure no credentials are hardcoded in any source files

When forking or sharing this project:

1. Make sure the .env file is not included
2. Check that no private keys are committed
3. Verify the .gitignore file is properly set up

Quick Start

1. Clone the repository

   git clone https://github.com/yourusername/tesla-mcp.git
   cd tesla-mcp
   

2. Install dependencies

   pnpm install
   

3. Set up environment variables Create a .env file in the root directory:

   TESLA_CLIENT_ID=your_client_id
   TESLA_CLIENT_SECRET=your_client_secret
   TESLA_REFRESH_TOKEN=your_refresh_token
   

4. Get a refresh token (if you don’t have one)

   pnpm get-token
   

5. Register your application with Tesla’s API

   pnpm register
   

   Follow the instructions provided by the script

6. Build the server

   pnpm build
   

7. Run the server

   pnpm start
   

Authentication & Registration

This project uses the official Tesla Fleet API OAuth 2.0 authentication flow to securely connect to your Tesla account. The full process involves two steps:

1. Authentication: Obtaining a refresh token through the OAuth 2.0 flow
2. Registration: Registering your application with Tesla via the Partner Accounts API

Authentication

Authentication requires:

• Client ID and Client Secret from the Tesla Developer Portal
• A refresh token obtained through the OAuth 2.0 authorization code flow

The included pnpm get-token utility simplifies this process by: