Talk to your Kia. "Did I lock the car? Pre-cool it for me. Where did I park? What was my driving score this week? Send 'IGI Airport T3' to nav. If the car leaves a 2 km radius after 11 PM, ping me."

An MCP server, CLI, and PWA dashboard for any Kia / Hyundai / Genesis vehicle that supports Kia Connect or Hyundai Bluelink. 52 tools, every cloud-API capability the official app exposes, plus computed insights the official app doesn't give you.

Wraps hyundai-kia-connect-api. Works in every region that library supports — Europe, USA, Canada, India, Australia, New Zealand, China, Brazil.

• MCP server (52 tools) — drop into Claude Code, Claude Desktop, or any MCP client and start talking to your car in plain English.
• CLI (kia-connect) — for shell scripts, cron jobs, voice assistants, terminal nerds.
• PWA dashboard (optional) — mobile-friendly FastAPI + Tailwind UI with server-side caching and SQLite trip history. Install to your iPhone home screen.

Every write/control command requires confirm=True so the LLM can't accidentally unlock your car or honk the horn. Two-step confirmation is hardcoded — not a setting.

Things you can suddenly do that the official app makes painful or impossible:

Requires Python 3.10+ and uv (recommended).

git clone https://github.com/sharozdawa/kia-connect-mcp.git
cd kia-connect-mcp
uv sync
cp .env.example .env
$EDITOR .env   # fill in KIA_USERNAME, KIA_PASSWORD, KIA_PIN

Edit .env:

Works with any Kia, Hyundai, or Genesis vehicle that has an active connected-car subscription:

• Kia Connect (formerly Kia UVO)
• Hyundai Bluelink
• Genesis Connected Services (Canada per the upstream library)

Compatibility is inherited from hyundai-kia-connect-api. Broadly: most Kia / Hyundai / Genesis vehicles with an active telematics SIM from roughly 2018 onwards, across the eight supported regions (Europe, USA, Canada, India, Australia, New Zealand, China, Brazil).

Model names vary by market — your local Cerato is a Forte in the US and a K3 in Korea / the Middle East. The MCP doesn't care about the marketing name; it talks to whatever your account returns.

• ✅ Kia Carens Clavis (India, 2026 — primary test vehicle for this repo)

If your model isn't above and you've successfully connected — open a PR and add it. If it doesn't work, open an issue with your region, brand, model year, and the error you see. Compatibility ultimately depends on (1) the upstream library supporting your region, (2) your connected-services subscription being active, and (3) which features your trim physically has (e.g. AC-only mode is EU-only, exact tire PSI is rare on Asian trims, sunroof status only if equipped).

claude mcp add kia-connect -- uv --directory /absolute/path/to/kia-connect-mcp run kia-mcp

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kia-connect": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/kia-connect-mcp", "run", "kia-mcp"],
      "env": {
        "KIA_USERNAME": "you@example.com",
        "KIA_PASSWORD": "...",
        "KIA_PIN": "0000",
        "KIA_REGION": "6",
        "KIA_BRAND": "1"
      }
    }
  }
}

./kia status         # full vehicle status
./kia locked         # lock state for all doors
./kia location       # GPS + Maps link
./kia trips          # today's trips
./kia driving-score  # day's driving analysis
./kia fuel-cost      # estimated fuel cost for today
./kia lock           # lock the doors
./kia ac-on 22 10    # AC at 22°C for 10 min
./kia road-trip 20260420   # full leg-by-leg road trip analysis
./kia geofence 19.0760 72.8777 1500   # 1.5 km geofence alert at this point
./kia help           # full command list (50+)

The ./kia wrapper auto-loads .env and runs through uv. Use it in cron, shell scripts, voice assistants, agents.

The web dashboard pulls in FastAPI + Jinja, an optional extra:

uv sync --extra web
uv run --python 3.13 uvicorn web.app:app --host 0.0.0.0 --port 8000

Open http://<your-machine>:8000 on your phone and "Add to Home Screen". Server-side caches read endpoints for 2 minutes; persists trips in trips.db.

You: Did I forget to lock the car? Claude: Front-left door is unlocked. Want me to lock it? (asks confirmation, locks)

You: I'm leaving in 15 minutes — pre-cool the car to 21° and check fuel. Claude: Fuel is at 38% (~280 km range). Start AC at 21° for 15 min? (confirms, starts)

You: Make a small report on my driving this week. Claude: (calls get_driving_summary) 6 days driven, 412 km, avg 42 km/h (mixed city), 3 hard-braking events, 1 rapid acceleration. Safety score 87/100. Highest day was Tuesday — 98 km, mostly highway.

You: I'm handing the car to a valet. Set safe limits. Claude: Setting valet alert: speed 60 km/h, idle 5 min. Confirm? (confirms, sets)

You: Where did I park at the airport? Claude: Last GPS: 28.5562°N, 77.1000°E (Indira Gandhi Intl Airport, T3 Parking). [Open in Maps]. Want me to flash the hazards when you're close?

You: Why is fuel dropping so fast this month? Claude: (calls get_driving_analysis for 5 recent days) Idle ratio is 22% (typical: 8–10%) and avg max speed is 118 km/h. Both push fuel use up ~20%. Suggestions: turn off engine at stops > 60s, hold 80–90 km/h on the highway.

• Confirmations are hardcoded. Every write tool returns {status: "confirmation_required"} first; you have to call again with confirm=True. The LLM can see the full effect before doing anything.
• Cloud API only. No OBD-II, no CAN bus poking — only what the Kia Connect / Bluelink cloud exposes. Safe.
• Rate limit. Kia/Hyundai's API enforces ~100 calls per window. The PWA caches reads for 2 min to stay polite.
• Cached vs live. Most read tools return what the car last uploaded (usually within minutes). Use get_live_status / force_refresh only when you genuinely need fresh data — they wake the TCU and drain the 12V slightly. Both are rate-limited to once per 30 min.
• PIN. Lock/unlock and a few other writes need KIA_PIN set. Read-only tools do not.
• Tested on. Kia Carens Clavis (India). See Compatible vehicles for the full list of models the underlying library supports — please open an issue or PR with results from your model.

Built on the excellent hyundai-kia-connect-api. All thanks to that project's maintainers — this repo is just the MCP / CLI / PWA layer on top.

MIT — see LICENSE.