Skip to main content

CarConnectivity Connector for Skoda Vehicles

GitHub sourcecode GitHub release (latest by date) GitHub GitHub issues PyPI - Downloads PyPI - Python Version Donate at PayPal Sponsor at Github

CarConnectivity will become the successor of WeConnect-python in 2025 with similar functionality but support for other brands beyond Volkswagen!

CarConnectivity is a python API to connect to various car services. This connector enables the integration of Škoda vehicles through the official Škoda Public API (public.api.connect.skoda-auto.cz). Look at CarConnectivity for other supported brands.

Getting an API key

Every request needs an API key. Keys are created and managed in the MyŠkoda app.

Are you on a mobile phone with MyŠkoda installed? Manage API keys

Reading this on a computer? Scan the QR code below with your phone to open key management in the app:

QR code linking to API key management in the MyŠkoda app

Don't have MyŠkoda? Download it here.

Prerequisites

This connector uses the official Škoda Public Vehicle API (beta). To use it you need:

  1. MyŠkoda app v8.16+ — create an API key in the app's key-management screen / QR flow.
  2. A list of VINs — the public API is vehicle-bound and has no list-vehicles endpoint; you must supply your VIN(s) explicitly.

Rate limit: The public API allows 20 requests per hour per API key. The default poll interval of 300 s (5 min) leaves headroom for commands. Do not lower the interval below 300 s.

Features supported by the public API

Feature Status
Vehicle status (doors, windows, lights) ✅
Fuel / battery level and range ✅
Odometer ✅
Parking position (GPS) ✅ (requires Remote Access licence)
Air conditioning status + start/stop ✅
Window heating status ✅
Charging status + start/stop ✅ (EV/hybrid only)
Charging settings (target SoC, mode, etc.) ✅ read-only
Honk & flash ❌ not in public API
Lock / unlock ❌ not in public API
Wake-up ❌ not in public API
Maintenance / inspection info ❌ not in public API
MQTT push events ❌ not in public API

Configuration

In your carconnectivity.json add a section for the skoda connector:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "skoda",
                "config": {
                    "api_key": "your-api-key-from-myskoda-app",
                    "vins": ["TMBJB9NY5RF999999"]
                }
            }
        ]
    }
}

Configuration options

Key Required Default Description
api_key see below — API key created in the MyŠkoda app
vins ✅ — List of VINs (or comma-separated string) the key covers
interval ❌ 300 Poll interval in seconds (minimum 300)
max_age ❌ interval - 1 Maximum cache age in seconds for vehicle data
max_age_static ❌ 86400 (24 hours) Maximum cache age in seconds for vehicle images
netrc ❌ ~/.netrc Path to a netrc file containing the API key

Credentials

The API key can be provided either directly in the config file or via a .netrc file.

Option 1 — config file:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "skoda",
                "config": {
                    "api_key": "your-api-key-from-myskoda-app",
                    "vins": ["TMBJB9NY5RF999999"]
                }
            }
        ]
    }
}

Option 2 — netrc file (API key in the password field):

# ~/.netrc
machine skoda
login unused
password your-api-key-from-myskoda-app

With netrc the config can omit api_key:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "skoda",
                "config": {
                    "vins": ["TMBJB9NY5RF999999"]
                }
            }
        ]
    }
}

You can also point to a custom netrc path:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "skoda",
                "config": {
                    "netrc": "/some/path/on/your/filesystem",
                    "vins": ["TMBJB9NY5RF999999"]
                }
            }
        ]
    }
}

Known issues

Unexpected keys found

Not all items that are presented in the data from the server are already implemented by the connector. Feel free to report interesting findings in your log data in the Discussions section or as an Issue (Enhancement). My time is very limited, so usually new features take some time to get into the library, also because I need to align functionality between the connectors of all brands.

Skoda, if you want to talk, contact me. I have some ideas how this can be improved for Skoda as well as the users!

Metadata

Release files for carconnectivity-connector-skoda 0.13.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for carconnectivity-connector-skoda 0.13.1
File Size Uploaded
carconnectivity_connector_skoda-0.13.1.tar.gz 32.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for carconnectivity-connector-skoda 0.13.1
File Interpreter ABI Platform
carconnectivity_connector_skoda-0.13.1-py3-none-any.whl Python 3 none any Details

Total release size: 60.7 kB

Release files / carconnectivity_connector_skoda-0.13.1.tar.gz

Download URL carconnectivity_connector_skoda-0.13.1.tar.gz
Size 32.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b06e942b2efdaedf80f280d0763099c687de0237bda2c1f2f7303745645a799a
BLAKE2b-256 checksum
How to use checksums
13a8a03c85a76a0bfb508a40bf7767e797f566c51553ca2b7b0a59d137c00636
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.

Transparency log

Release files / carconnectivity_connector_skoda-0.13.1-py3-none-any.whl

Download URL carconnectivity_connector_skoda-0.13.1-py3-none-any.whl
Size 28.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d347a9e5013a557cb1bf6dc010911a34eb9d23fd0e2acb8d5f213e6993bd5b3
BLAKE2b-256 checksum
How to use checksums
ba09321b0d05afc3379a0c1c9519f2f79a813e1b4aa79712bdc368ac28070ea2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.13.1 This release

2 release files

0.13

2 release files

0.12.5

2 release files

0.12.4

2 release files

0.12.3

2 release files

0.12.2

2 release files

0.12.1

2 release files

0.12

2 release files

0.11.8

2 release files

0.11.7

2 release files

0.11.4

1 release file

0.11

2 release files

0.10

2 release files

0.9

2 release files

0.9a1

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7

2 release files

0.6

2 release files

0.5

2 release files

0.5a2

2 release files

0.5a1

2 release files

0.4.1

2 release files

0.4

2 release files

0.4a8

2 release files

0.4a7

2 release files

0.4a6

2 release files

0.4a5

2 release files

0.4a4

2 release files

0.4a3

2 release files

0.4a2

2 release files

0.4a1

2 release files

0.3

2 release files

0.2a5

2 release files

0.2a4

2 release files

0.2a3

2 release files

0.2a2

2 release files

0.2a1

2 release files

0.1

2 release files

0.1a22

2 release files

0.1a21

2 release files

0.1a20

2 release files

0.1a19

2 release files

0.1a18

2 release files

0.1a17

2 release files

0.1a16

2 release files

0.1a14

2 release files

0.1a13

2 release files

0.1a12

2 release files

0.1a9

2 release files

0.1a8

2 release files

0.1a7

2 release files

0.1a6

2 release files

0.1a5

2 release files

0.1a4

2 release files

0.1a3

2 release files

0.1a2

2 release files

0.1a1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page