Smartcar MCP Server

An MCP (Model Context Protocol) server that exposes Smartcar's vehicle API as tools for AI agents. Enables Claude, ChatGPT, and other MCP-compatible clients to query vehicle telemetry and send commands using natural language.

Overview

This server wraps Smartcar's M2M (machine-to-machine) API using OAuth2 client credentials. It handles token acquisition and caching automatically, so AI agents interact with vehicles without managing auth.

16 tools across 4 categories:

Usage

No installation needed. Add this to your claude_desktop_config.json (or equivalent MCP client config):

{
  "mcpServers": {
    "smartcar": {
      "command": "npx",
      "args": ["-y", "smartcar-mcp"],
      "env": {
        "SMARTCAR_CLIENT_ID": "your-client-id",
        "SMARTCAR_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Environment variables

Development

git clone https://github.com/thachdoSC/smartcar-mcp-test
cd smartcar-mcp
npm install
npm run dev   # run from source
npm run build # compile to dist/

Tools Reference

Connections

list_connections — List vehicle connections with optional filters.

get_connection — Get a single connection by ID.

delete_connection — Delete a connection by ID.

delete_user — Delete a user and all associated data.

Signals (Telemetry)

get_signals — List all available signals for a vehicle.

get_signal — Fetch the current value of a specific signal.

Charge: charge.ischarging, charge.voltage, charge.wattage, charge.amperage, charge.limit, charge.estimation.durationtocompletion, charge.estimation.distance_added, charge.estimation.kwh_added, charge.estimation.percent_added, charge.session.id, charge.session.starttime, charge.session.endtime, charge.session.kwhadded, charge.session.milesadded, charge.session.porttype, charge.session.cost, charge.schedule.type, charge.schedule.starttime, charge.schedule.day, charge.schedule.enabled, charge.porttype, charge.portstatus

Climate: climate.externaltemperature, climate.internaltemperature

Closure: closure.door, closure.lock, closure.window, closure.sunroof, closure.fronttrunk, closure.reartrunk, closure.chargeport

Connectivity: connectivity.firmware, connectivity.isonline, connectivity.sleepstate, connectivity.lastseenat

Diagnostics: diagnostics.faultcodes, diagnostics.oil, diagnostics.emissions, diagnostics.abs, diagnostics.airbag, diagnostics.battery.maintenancestatus, diagnostics.battery.range, diagnostics.battery.soc, diagnostics.brakebooster, diagnostics.brakefluid, diagnostics.collision, diagnostics.coolant, diagnostics.cruisecontrol, diagnostics.enginelight, diagnostics.hazardlights, diagnostics.headlights, diagnostics.park, diagnostics.stabilitycontrol, diagnostics.steeringlock, diagnostics.transmission, diagnostics.washerfluid

HVAC: hvac.cabintemperature, hvac.defroster, hvac.heater, hvac.temperatureset, hvac.ventilation

ICE (Internal Combustion Engine): ice.fuel.level, ice.fuel.range, ice.fuel.percentremaining, ice.oillife

Location: location.precise, location.ishome

Low voltage battery: lowvoltagebattery.stateofcharge, lowvoltagebattery.status

Motion: motion.speed

Odometer: odometer.distance

Service: service.isinservice, service.records

Surveillance: surveillance.brand, surveillance.isenabled

Traction battery: tractionbattery.stateofcharge, tractionbattery.range, tractionbattery.heating, tractionbattery.capacity.kwh, tractionbattery.capacity.usableKwh, tractionbattery.limit, tractionbattery.temperature, tractionbattery.chargecompletiontime, tractionbattery.fullchargetime

Transmission: transmission.drivemode, transmission.gear

Vehicle ID: vehicleid.vin, vehicleid.color, vehicleid.trim, vehicleid.packages, vehicleid.nickname

Vehicle user account: vehicleuseraccount.grantedpermissions, vehicleuseraccount.role

Wheel: wheel.style, wheel.tires

Vehicle Commands

All command tools require vehicle_id and user_id.

lock_vehicle — Lock vehicle doors.

unlock_vehicle — Unlock vehicle doors.

start_charge — Start EV charging.

stop_charge — Stop EV charging.

set_charge_limit — Set the maximum charge level.

set_navigation_destination — Send a GPS destination to the vehicle's nav system.

Management

list_applications — List all Smartcar applications in your organization.

get_application — Get details for a specific application by ID.

list_application_secrets — List credentials for an application (secret values are not returned).

Project Structure

src/
├── index.ts          # Server entry point — wires up tools and transport
├── auth.ts           # OAuth2 token manager with in-memory caching
├── client.ts         # HTTP client for Smartcar REST APIs
└── tools/
    ├── connections.ts # Connection and user management tools
    ├── signals.ts     # Vehicle telemetry tools
    ├── commands.ts    # Vehicle control command tools
    └── management.ts  # Application management tools

Authentication

The server uses OAuth2 client credentials (M2M flow). Tokens are cached in memory and refreshed automatically 60 seconds before expiry. No manual token management is needed.