# Hyundai Bluelink / Kia Connect

> Hyundai Bluelink / Kia Connect is an open-source MCP server for vehicles and mobility. Check charge, range, locks and location of a Hyundai, Kia or Genesis, and pre-heat it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, macOS, Windows, Linux
- **Website:** https://bluelink-mcp.mattoddie.dev
- **Repository:** https://github.com/mattoddie/bluelink-mcp
- **MCP Registry name:** io.github.mattoddie/bluelink-mcp
- **Categories:** vehicles and mobility
- **Listing updated:** 2026-11-15

## About

The server is read-only until you opt in. Seven read tools cover vehicles, last reported status, a rate-limited live refresh, trips, daily energy use and command results, and location is off unless allowed because it reveals where you live and park. Commands and unlocking are two separate switches, and tools that are not allowed are never registered, so the assistant cannot call them or be talked into it.

With writes enabled it can lock, start and stop climate with temperature, defrost, heated seats and steering wheel, start and stop charging, set charge limits and flash the hazard lights. Unlocking needs a further flag and confirmation each time. An optional audit log records each command without its location.

It is built on the library behind the Home Assistant integration and works with Bluelink, Kia Connect and Genesis Connect across Europe, the USA, Canada, Australia and other regions. It is unofficial, and the vehicle makers' APIs are undocumented and can change. Waking the car is rate limited to spare its 12V battery.

## Features

- **Read-only by default:** Commands and unlock each need their own switch.
- **Vehicle status:** Charge, fuel, range, locks, doors, windows, tyres and warnings.
- **Climate control:** Starts or stops pre-conditioning with temperature, defrost, seats and steering wheel.
- **Charging control:** Starts or stops charging and sets AC and DC limits.
- **Trips and energy:** Daily trips, monthly summaries and energy use.
- **Audit log:** Optionally records every command sent to the car.

## Good for

- Ask whether the car is charged and locked
- Warm the cabin before leaving
- Review a month of driving
- Find where you parked

## Install

### Claude Code (Terminal)

```sh
claude mcp add bluelink-mcp --env BLUELINK_USERNAME='<BLUELINK_USERNAME>' --env BLUELINK_PASSWORD='<BLUELINK_PASSWORD>' --env BLUELINK_PIN='<BLUELINK_PIN>' -- docker run -i --rm -e BLUELINK_USERNAME -e BLUELINK_PASSWORD -e BLUELINK_PIN ghcr.io/mattoddie/bluelink-mcp:0.6.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bluelink-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLUELINK_USERNAME",
        "-e",
        "BLUELINK_PASSWORD",
        "-e",
        "BLUELINK_PIN",
        "ghcr.io/mattoddie/bluelink-mcp:0.6.0"
      ],
      "env": {
        "BLUELINK_USERNAME": "<BLUELINK_USERNAME>",
        "BLUELINK_PASSWORD": "<BLUELINK_PASSWORD>",
        "BLUELINK_PIN": "<BLUELINK_PIN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bluelink-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLUELINK_USERNAME",
        "-e",
        "BLUELINK_PASSWORD",
        "-e",
        "BLUELINK_PIN",
        "ghcr.io/mattoddie/bluelink-mcp:0.6.0"
      ],
      "env": {
        "BLUELINK_USERNAME": "<BLUELINK_USERNAME>",
        "BLUELINK_PASSWORD": "<BLUELINK_PASSWORD>",
        "BLUELINK_PIN": "<BLUELINK_PIN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bluelink-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLUELINK_USERNAME",
        "-e",
        "BLUELINK_PASSWORD",
        "-e",
        "BLUELINK_PIN",
        "ghcr.io/mattoddie/bluelink-mcp:0.6.0"
      ],
      "env": {
        "BLUELINK_USERNAME": "<BLUELINK_USERNAME>",
        "BLUELINK_PASSWORD": "<BLUELINK_PASSWORD>",
        "BLUELINK_PIN": "<BLUELINK_PIN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bluelink-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLUELINK_USERNAME",
        "-e",
        "BLUELINK_PASSWORD",
        "-e",
        "BLUELINK_PIN",
        "ghcr.io/mattoddie/bluelink-mcp:0.6.0"
      ],
      "env": {
        "BLUELINK_USERNAME": "<BLUELINK_USERNAME>",
        "BLUELINK_PASSWORD": "<BLUELINK_PASSWORD>",
        "BLUELINK_PIN": "<BLUELINK_PIN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bluelink-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BLUELINK_USERNAME",
        "-e",
        "BLUELINK_PASSWORD",
        "-e",
        "BLUELINK_PIN",
        "ghcr.io/mattoddie/bluelink-mcp:0.6.0"
      ],
      "env": {
        "BLUELINK_USERNAME": "<BLUELINK_USERNAME>",
        "BLUELINK_PASSWORD": "<BLUELINK_PASSWORD>",
        "BLUELINK_PIN": "<BLUELINK_PIN>"
      }
    }
  }
}
```

## Tools

- `list_vehicles`: Lists vehicles on the account.
- `get_vehicle_status`: Last reported battery or fuel, range, charging, climate, locks, doors, windows and tyres.
- `refresh_vehicle_status`: Wakes the car for live data, rate limited.
- `get_vehicle_location`: Latitude, longitude, map link and optional address.
- `get_trips`: A day's trips or a month's summary.
- `get_energy_usage`: Daily energy use for driving, climate, electronics and battery care.
- `get_command_status`: Result of an earlier command.
- `lock_vehicle`: Locks the doors.
- `start_climate`: Pre-conditions the cabin.
- `stop_climate`: Stops pre-conditioning.
- `start_charging`: Starts charging.
- `stop_charging`: Stops charging.
- `set_charge_limits`: Sets AC and DC charge limits.
- `flash_hazard_lights`: Flashes the hazards to find the car.
- `unlock_vehicle`: Unlocks the doors.

## FAQ

### Which brands work?

Hyundai Bluelink, Kia Connect and Genesis Connect, in most regions.

### Can it unlock the car?

Only if both writes and unlock are enabled, and each unlock is confirmed.

### Is it official?

No. It is unofficial and not affiliated with Hyundai, Kia or Genesis.

### How do I run it?

Use Docker, uv, or the one-click Claude Desktop bundle; a Bluelink or Kia Connect login is required.

### Is Hyundai Bluelink / Kia Connect free?

Yes. Hyundai Bluelink / Kia Connect is open source, so you can use and self-host it for free.

### How do I add Hyundai Bluelink / Kia Connect to Claude Code?

Run this command in your terminal: claude mcp add bluelink-mcp --env BLUELINK_USERNAME='<BLUELINK_USERNAME>' --env BLUELINK_PASSWORD='<BLUELINK_PASSWORD>' --env BLUELINK_PIN='<BLUELINK_PIN>' -- docker run -i --rm -e BLUELINK_USERNAME -e BLUELINK_PASSWORD -e BLUELINK_PIN ghcr.io/mattoddie/bluelink-mcp:0.6.0

### What are the best alternatives to Hyundai Bluelink / Kia Connect?

The closest alternatives to Hyundai Bluelink / Kia Connect are Azuga MCP by usefulapi and USDOT Operating Authority and Insurance Status Sentinel.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Azuga MCP by usefulapi](https://ai-powered.com/mcp/azuga-mcp-by-usefulapi): Azuga MCP by usefulapi is a freemium MCP server for vehicles and mobility.
- [USDOT Operating Authority and Insurance Status Sentinel](https://ai-powered.com/mcp/usdot-operating-authority-and-insurance-status-sentinel): USDOT Operating Authority and Insurance Status Sentinel is a freemium MCP server for vehicles and mobility.

---
Source: https://ai-powered.com/mcp/hyundai-bluelink-kia-connect
