---
id: mysqlclient
version: "2.2.8"
license: GPL-2.0-or-later
license_treatment: copyleft
maintenance: active
---

# mysqlclient — Python interface to MySQL

License: copyleft · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install mysqlclient
uv add mysqlclient
poetry add mysqlclient

## Description

# mysqlclient

This project is a fork of [MySQLdb1](https://github.com/farcepest/MySQLdb1).
This project adds Python 3 support and fixed many bugs.

* PyPI: https://pypi.org/project/mysqlclient/
* GitHub: https://github.com/PyMySQL/mysqlclient


## Support

**Do Not use Github Issue Tracker to ask help.  OSS Maintainer is not free tech support**

When your question looks relating to Python rather than MySQL/MariaDB:

* Python mailing list [python-list](https://mail.python.org/mailman/listinfo/python-list)
* Slack [pythondev.slack.com](https://pyslackers.com/web/slack)

Or when you have question about MySQL/MariaDB:

* [MySQL Support](https://dev.mysql.com/support/)
* [Getting Help With MariaDB](https://mariadb.com/kb/en/getting-help-with-mariadb/)

## Free threading Python

> [!NOTE]
> The support for Free threading Python is experimental.

Since v2.2.8, free threading is supported when importing the extension module. Therefore, importing MySQLdb does not acquire GIL.

However, this library does not support simultaneous operations on a single Connection object from multiple threads, regardless of free threading, and the behavior in such cases...

## AI interpretation — verify before relying

mysqlclient provides a Python interface to MySQL and MariaDB databases, enabling direct connections and query execution from Python 3 applications.

Verdict: mysqlclient is a stable, actively maintained MySQL/MariaDB driver for Python 3.10+ with no known vulnerabilities. Medium install friction is offset by pre-built wheels on Windows and straightforward setup on Unix-like systems. GPL-2.0-or-later licensing requires careful review for proprietary projects.

[View on SkillFed](https://skillfed.io/packages/mysqlclient) · [View on PyPI](https://pypi.org/project/mysqlclient/)