unofficial-polestar-mcp

MCP server for controlling your Polestar from Claude — climate, charging, locks, location and vehicle status via natural language.

unofficial-polestar-mcp is a Model Context Protocol server that connects Claude to your Polestar. Ask Claude to precondition the cabin, set charge limits, check battery and range, find where you parked, or flash the lights — all through the same cloud APIs the official app uses. Safety-critical actions (unlock, open windows) require explicit confirmation. Built on the unofficial-polestar-api library. Not affiliated with Polestar.

Tools

* Requires explicit user confirmation (confirm=true) before the command is sent.

If your account has a single vehicle it is selected automatically; otherwise pass a vin argument or set POLESTAR_VIN.

Related MCP server: Tesla MCP Server

Installation

Requires Python 3.11+.

macOS / Linux:

git clone https://github.com/<you>/unofficial-polestar-mcp
cd unofficial-polestar-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

The server binary is at .venv/bin/polestar-mcp.

Windows (PowerShell):

git clone https://github.com/<you>/unofficial-polestar-mcp
cd unofficial-polestar-mcp
python -m venv .venv
.venv\Scripts\pip install -e .

The server binary is at .venv\Scripts\polestar-mcp.exe.

Configuration

The server authenticates with your Polestar account credentials via environment variables:

Tokens are cached on disk (mode 0600 on macOS/Linux; on Windows the file inherits your user profile's ACLs) so restarts reuse the refresh token instead of re-running the full login.

Claude Desktop (macOS / Windows)

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "polestar": {
      "command": "/path/to/unofficial-polestar-mcp/.venv/bin/polestar-mcp",
      "env": {
        "POLESTAR_EMAIL": "you@example.com",
        "POLESTAR_PASSWORD": "your-password"
      }
    }
  }
}

On Windows, use the Scripts binary and escape backslashes in JSON:

"command": "C:\\path\\to\\unofficial-polestar-mcp\\.venv\\Scripts\\polestar-mcp.exe"

Claude Code (macOS / Linux / Windows)

claude mcp add polestar \
  -e POLESTAR_EMAIL=you@example.com \
  -e POLESTAR_PASSWORD=your-password \
  -- /path/to/unofficial-polestar-mcp/.venv/bin/polestar-mcp

On Windows, point to .venv\Scripts\polestar-mcp.exe instead.

Example prompts

• "How charged is my Polestar and what's the range?"

• "Precondition the car to 21° and turn on the driver's seat heater."

• "Set the charge limit to 80% and start charging now."

• "Where did I park?"

• "Flash the lights, I can't find the car."

Safety & disclaimer

• Unlocking the car or trunk and opening windows are gated behind an explicit confirmation step — Claude must ask you before sending those commands.

• This project uses unofficial, reverse-engineered APIs. They can break or change at any time. Use at your own risk.

• Not affiliated with, endorsed by, or supported by Polestar.

License

MIT