Vehicle MCP

A Model Context Protocol (MCP) server for controlling your vehicle. Check battery status, control climate, lock/unlock doors, and more — from your AI assistant.

<img src="assets/demo.gif" width="400" height="401" alt="Demo">

Supported brands:

| Brand | Uses | |-------|------| | Skoda | https://github.com/skodaconnect/myskoda |

Tools

get_vehicle_info and get_vehicle_status are always available. The remaining tools are enabled based on your vehicle's detected capabilities.

| Tool | Description | |------|-------------| | get_vehicle_info | Static vehicle info (VIN, model, year, etc.) | | get_vehicle_status | Current status (battery, range, location, etc.) | | start_climate_control | Start heating/cooling | | stop_climate_control | Stop climate control | | start_charging | Start charging | | stop_charging | Stop charging | | lock_vehicle | Lock vehicle | | unlock_vehicle | Unlock vehicle |

Usage

Add to your MCP client configuration:

{
  "mcpServers": {
    "vehicle": {
      "command": "uvx",
      "args": ["vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "your-email@example.com",
        "PASSWORD": "your-password"
      }
    }
  }
}

<details> <summary>Docker</summary>

Docker images track main and may include unreleased changes. For stable releases, use uvx above.

{
  "mcpServers": {
    "vehicle": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAND", "-e", "USERNAME", "-e", "PASSWORD", "ghcr.io/antonlunden/vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "your-email@example.com",
        "PASSWORD": "your-password"
      }
    }
  }
}

</details>

| Variable | Required | Description | |----------|----------|-------------| | BRAND | Yes | Vehicle brand (skoda) | | USERNAME | Yes | Email for your vehicle's connected services | | PASSWORD | Yes | Password for your vehicle's connected services | | VIN | No | Vehicle VIN (auto-detects if not set) | | SECURE_PIN | For lock/unlock (Skoda) | S-PIN configured in Skoda Connect app |

Multiple Vehicles

Different accounts

Add multiple server entries — VIN will be auto-detected:

{
  "mcpServers": {
    "my-skoda": {
      "command": "uvx",
      "args": ["vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "me@example.com",
        "PASSWORD": "my-password"
      }
    },
    "partners-skoda": {
      "command": "uvx",
      "args": ["vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "partner@example.com",
        "PASSWORD": "their-password"
      }
    }
  }
}

Same account

Specify the VIN for each vehicle:

{
  "mcpServers": {
    "family-car": {
      "command": "uvx",
      "args": ["vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "me@example.com",
        "PASSWORD": "my-password",
        "VIN": "TMBXXXXXXXXXXXXXX"
      }
    },
    "weekend-car": {
      "command": "uvx",
      "args": ["vehicle-mcp"],
      "env": {
        "BRAND": "skoda",
        "USERNAME": "me@example.com",
        "PASSWORD": "my-password",
        "VIN": "TMBYYYYYYYYYYYYYYY"
      }
    }
  }
}

Contributing

See CONTRIBUTING.md.