bluelink-mcp
An MCP server that lets AI assistants such as Claude read and control your Hyundai, Kia or Genesis vehicle: lock and unlock, remote climate, charging, status, location and trips.
It wraps the open-source
hyundai_kia_connect_api library
and runs on your own computer. Your credentials never leave your machine except to log in to
Hyundai or Kia.
Disclaimer. This project is not affiliated with, endorsed by, or supported by Hyundai, Kia or Genesis. It uses unofficial, reverse-engineered APIs that the manufacturers can change or block at any time. Remote commands act on a real vehicle. Use it at your own risk.
Requirements
- An active Bluelink / Kia Connect / Genesis Connected Services account.
- uv (recommended), or Python 3.13 or later with
pip. - An MCP client that runs local servers: Claude Desktop, Claude Code, Cursor, VS Code, and others.
Claude on the web and mobile, ChatGPT and Grok cannot start a program on your computer, so they cannot use this server.
Configuration
The server reads these environment variables:
| Variable | Required | Description |
|---|---|---|
BLUELINK_USERNAME |
yes | Account email or username. |
BLUELINK_PASSWORD |
yes | Account password. |
BLUELINK_PIN |
Hyundai or Genesis in the USA | Remote-command PIN. |
BLUELINK_REGION |
yes | USA, Canada, Europe, Australia, New Zealand, China, India or Brazil. |
BLUELINK_BRAND |
yes | Hyundai, Kia or Genesis. |
BLUELINK_LANGUAGE |
no | Default en. |
BLUELINK_TOKEN_PATH |
no | Default ~/.bluelink-mcp/token.json. |
Values are case-insensitive. The server also reads a .env file from the current working
directory; real environment variables take priority. See .env.example.
Add it to your client
Claude Desktop
-
Open Settings → Developer → Edit Config. This opens
claude_desktop_config.json. -
Add a
bluelinkentry insidemcpServers:{ "mcpServers": { "bluelink": { "command": "uvx", "args": ["bluelink-mcp"], "env": { "BLUELINK_USERNAME": "you@example.com", "BLUELINK_PASSWORD": "your-password", "BLUELINK_PIN": "0000", "BLUELINK_REGION": "USA", "BLUELINK_BRAND": "Hyundai" } } } }
-
Quit Claude Desktop completely and start it again.
Claude Code
claude mcp add bluelink -e BLUELINK_USERNAME=you@example.com -e BLUELINK_PASSWORD=your-password -e BLUELINK_PIN=0000 -e BLUELINK_REGION=USA -e BLUELINK_BRAND=Hyundai -- uvx bluelink-mcp
Without uv
Run pip install bluelink-mcp, then use bluelink-mcp as the command instead of uvx.
Then ask your assistant something like "Is my car locked?"
Tools
The server registers only the tools that your region and brand support. It logs the list at startup.
| Area | Tools |
|---|---|
| Vehicles and status | list_vehicles, get_vehicle_status, get_location, get_trip_info_month, get_trip_info_day, check_action_status |
| Doors | lock, unlock, door_power_off, open_frunk |
| Climate | start_climate, stop_climate, start_pet_care, stop_pet_care, start_battery_conditioning, stop_battery_conditioning |
| Charging (EV/PHEV) | start_charge, stop_charge, set_charge_limits, set_charging_current, open_charge_port, close_charge_port, set_charge_alarm, set_v2l_discharge_limit |
| Other | start_hazard_lights, start_hazard_lights_and_horn, set_windows, start_valet_mode, stop_valet_mode, turn_off_lamp, stop_rear_seat_alarm, set_navigation |
| Schedules | schedule_charging_and_climate, schedule_reservation_charge, schedule_reservation_hvac, schedule_reservation_engine |
| Login (OTP regions) | send_otp, verify_otp |
For example, Hyundai USA gets 15 tools: status, location, trips, lock and unlock, climate, charging, and hazard lights and horn.
Each vehicle's vehicle_id is the last 6 characters of its VIN.
Safety: confirm=true
These tools send nothing unless you pass confirm=true: unlock, start_hazard_lights_and_horn,
open_charge_port, set_windows (when a window opens), start_valet_mode, stop_valet_mode,
open_frunk, door_power_off and set_v2l_discharge_limit. Without it they return a message that
names the effect, so the assistant must ask you first. They also carry the MCP destructive hint.
start_climate is not guarded. On gas vehicles it starts the engine.
One-time passcode (Kia USA and others)
Some regions need a one-time passcode at login. The assistant calls send_otp (email or SMS), you
give it the code, and it calls verify_otp.
Token file
After login the server stores the session token in ~/.bluelink-mcp/token.json, or in
BLUELINK_TOKEN_PATH. The file never holds your password or PIN, and only your user account can
read it. Delete the file to force a fresh login.
Development
git clone https://github.com/gowthamand7/bluelink-mcp
cd bluelink-mcp
uv venv
uv pip install -e ".[dev]"
uv run pytest
License
MIT. See LICENSE.
Metadata
Release files for bluelink-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bluelink_mcp-0.1.0.tar.gz | 21.4 kB | Without provenance | Details for bluelink_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bluelink_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for bluelink_mcp-0.1.0-py3-none-any.whl |
Total release size: 38.5 kB
Release files / bluelink_mcp-0.1.0.tar.gz
| Download URL | bluelink_mcp-0.1.0.tar.gz |
|---|---|
| Size | 21.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c49768cb510b7d413d971c2344b7492e584a1a36e01133a72471c21e42cc61d
|
|
BLAKE2b-256 checksum How to use checksums |
c5162f16ca8c17f9fa044b1b094158a695098c124756c0239ed037f58b504e47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / bluelink_mcp-0.1.0-py3-none-any.whl
| Download URL | bluelink_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8790a7899c60698944475dfb55d743a29968677425acbbc956c43c141aaa03b2
|
|
BLAKE2b-256 checksum How to use checksums |
4e07bffecd8e91576aed8c009093833539695ebc6938b2d91ec707cad8cc28e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for bluelink-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.