bluelink-mcp
Reads and controls Hyundai vehicles via the Bluelink API: vehicle list and status, location and monthly/daily trip info, lock/unlock, frunk, remote climate and pet care, charging controls and schedules (EV/PHEV), hazard lights and horn, windows, valet mode, navigation and action status polling.
Reads and controls Kia vehicles via the Kia Connect API: vehicle status, location and trip information, locking and unlocking, remote climate, charging management and schedules for EV/PHEV models, hazard lights and horn, plus one-time-passcode login flow.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.
Related MCP server: Tessie MCP Server
Configuration
The server reads these environment variables:
Variable | Required | Description |
| yes | Account email or username. |
| yes | Account password. |
| Hyundai or Genesis in the USA | Remote-command PIN. |
| yes |
|
| yes |
|
| no | Default |
| no | Default |
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-mcpWithout 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 |
|
Doors |
|
Climate |
|
Charging (EV/PHEV) |
|
Other |
|
Schedules |
|
Login (OTP regions) |
|
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 pytestLicense
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Control your Tesla from your AI assistant - climate, charging, access, and security.
AI for your car: check charge, start climate, lock/unlock, open trunk via Tesla Fleet API. OAuth.
Tesla data for your AI: battery, range, charging, tires, alerts, history. Controls off by default.
Tesla Fleet API for AI: send navigation destinations, read battery and location, run car commands.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to access vehicle data from the DIMO Network, including querying telemetry, executing vehicle commands (lock/unlock, charging), decoding VINs, minting vehicle NFTs, and creating verifiable credentials.2MIT- AlicenseAqualityDmaintenanceEnables AI assistants to control and monitor Tesla vehicles via natural language through the Tessie API, supporting battery, climate, security, charging, and more.611MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control vehicles by checking battery status, managing climate, and locking/unlocking doors via Skoda Connect integration.3Apache 2.0
- AlicenseAqualityAmaintenanceA Model Context Protocol server that connects Claude to your own Kia vehicle through the Kia Owners API, enabling vehicle status, location, odometer, EV charge state, and confirm-gated commands for doors, climate, and charging.16237 npmMIT