NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #4023 most downloaded on PyPI
Python bindings for libmongocrypt
Latest stable
1.21.2
Last release 1 months ago
15 Oct 2026
Release timing varies
gaps range from 2 weeks to 6 months
Nearly every release is documented
notes for 34 of 34 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
42 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Community notes: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=10004&version=53218
Your coding agent can read these notes before it upgrades. Set up the MCP server →
PGP-Signing-Key: https://pgp.mongodb.com/python-driver.pub
PGP-Signing-Key: https://pgp.mongodb.com/python-driver.pub
linux-x86_64-glibc_2_7-nocrypto build instead as it has an equivalent glibc requirement.PGP-Signing-Key: https://pgp.mongodb.com/python-driver.pub
PGP-Signing-Key: https://pgp.mongodb.com/python-driver.pub
Stable support for prefix and suffix queries:
prefixPreview query type is replaced with prefix.suffixPreview query type is replaced with suffix.string algorithm (formerly textPreview) for prefix, suffix, and substringPreview query types.prefixPreview and suffixPreview query types.Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-19-0-released/343285
Bundle libmongocrypt 1.20.4 in release wheels.
Renamed the text_opts parameter of ExplicitEncryptOpts and ExplicitEncrypter.encrypt to string_opts, matching the "string" algorithm it configures. This is a breaking change.
The "textPreview" algorithm has been removed. Use "string" instead.
The "prefixPreview", "suffixPreview", and "substringPreview" query types are now deprecated aliases of "prefix", "suffix", and "substring". Prefer the new names, as a future release removes the aliases.
Bundle libmongocrypt 1.18.2: reject large KMS replies.
Bundle libmongocrypt 1.18.2: reject large KMS replies.
caseSensitive and diacriticSensitive options.
Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-18-0-is-now-available/339397
Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-18-0-is-now-available/339397
nocrypto in the name have no dependency on OpenSSL. Drivers using the nocrypto variant are expected to set crypto callbacks (e.g. call mongocrypt_setopt_crypto_hooks) to do operations requiring crypto to avoid an error.keyAltName in encryptedFieldsMap.release in the repository configuration in place of the major/minor version (e.g., 1.17). Details in README.md.linux-x86_64-glibc_2_7-nocrypto release build may be used instead and has equivalent glibc requirements.s3.amazonaws.com URLs to download libmongocrypt binaries. Please see binaries attached to the GitHub release.ENABLE_WINDOWS_STATIC_RUNTIME has been removed. Users that need the static MSVCRT library should instead set the CMAKE_MSVC_RUNTIME_LIBRARY built-in CMake parameter when configuring libmongocrypt.Support mixing QE and unencrypted JSON schemas.
FindPython instead of FindPythonInterp and FindPythonLibs).Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-17-0-released/331651
Set CMake minimum required version to 3.15...4.0 (with maximum policy version set to 4.0).
3.15...4.0 (with maximum policy version set to 4.0).FetchContent_MakeAvailable() is used to populate dependencies instead of FetchContent_Populate().
MONGOCRYPT_MONGOC_DIR is not set to USE-SYSTEM.MONGOCRYPT_DFP_DIR is not set to USE-SYSTEM.FetchContent_Populate() is still used for CMake versions prior to 3.18 to avoid add_subdirectory() behavior.-fPIC in CMake targets.Add support for text-based Queryable Encryption with the new "textPreview" algorithm. NOTE: The "textPreview" algorithm is experimental only. It is not intended for public use.
Fix possible error when text options include multiple query types and are used for a find payload: Text search query specification cannot contain mult
Text search query specification cannot contain multiple query type specifications.Support experimental Queryable Encryption text indexes with cleanupStructuredEncryptionData and compactStructuredEncryptionData.
cleanupStructuredEncryptionData and compactStructuredEncryptionData.textPreview and query types: prefixPreview, suffixPreview and substringPreview
mongocrypt_setopt_algorithm_text to apply options for explicit encryption.buildinfo (previously only buildInfo was bypassed).serverStatus.Fix possible missing error state on mongocrypt_ctx_finalize.
mongocrypt_ctx_finalize.Support experimental Queryable Encryption text indexes for automatic encryption.
ENABLE_EXTRA_ALIGNMENT=ON).mongocrypt_ctx_rewrap_many_datakey_init.Bundle libmongocrypt 1.13.1 in release wheels.
key_expiration_ms option to MongoCryptOptions.$lookup in CSFLE and QE.$lookup stages in aggregate pipelines on MongoDB server 8.1+.ENABLE_EXTRA_ALIGNMENT=ON.Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-12-2-released/308984
Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-12-2-released/308984
Nothing published for this version
The Windows download URLs for stable and unstable are now deprecated. See the GitHub Release page for Windows downloads.
Community notes: https://www.mongodb.com/community/forums/t/pymongocrypt-1-11-0-released/296028
Bundle libmongocrypt 1.11.0 in release wheels.
Add support for Python 3.13.
Fix bug in Python async support for AsyncMongoCryptCallback.fetch_keys.
Document range algorithm as unstable.
range algorithm as unstable.Drop support for Python 3.7 and PyPy 3.8. Python >=3.8 or PyPy >=3.9 is now required.
Full Changelog: https://github.com/mongodb/libmongocrypt/compare/pymongocrypt-1.9.2...pymongocrypt-1.10.0
delegated option.bulkWrite command.range algorithm as unstable.Nothing published for this version
https://www.mongodb.com/community/forums/t/pymongocrypt-1-9-2-released/282517
https://www.mongodb.com/community/forums/t/pymongocrypt-1-9-2-released/282517
https://www.mongodb.com/community/forums/t/pymongocrypt-1-9-0-and-1-9-1-released/268543
https://www.mongodb.com/community/forums/t/pymongocrypt-1-9-0-and-1-9-1-released/268543
This release adds stable support of the Queryable Encryption (QE) feature for the "Indexed" and "Unindexed" algorithms.
This release adds stable support of the Queryable Encryption (QE) feature for the "Indexed" and "Unindexed" algorithms.
Update from manylinux2010 to manylinux2014 wheels.
Bundle libmongocrypt 1.8.4 in release wheels.
Add support for manylinux_2_28_aarch64 wheels.
Support for range index. NOTE: The Range algorithm is experimental only. It is not intended for public use.
Add support for Python 3.12 on MacOS and Linux.
Update required cryptography version to >=2.5.
Fix libbson dependency in pkg-config for PPA.
Support accessToken to authenticate with Azure.
collMod command includes validator.$jsonSchema.Drop support for Python 2 and Python <3.7. Python >=3.7 is now required.
Bundle libmongocrypt 1.8.0 in release wheels.
Remove support for libmongocrypt <=1.8.0, libmongocrypt >=1.8.0 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Fix a potential data corruption bug in RewrapManyDataKey when rotating encrypted data encryption keys backed by GCP or Azure key services.
Fix a potential data corruption bug in RewrapManyDataKey when rotating encrypted data encryption keys backed by GCP or Azure key services.
The following conditions will trigger this bug:
The result of this bug is that the key material for all data encryption keys being rewrapped is replaced by new randomly generated material, destroying the original key material.
To mitigate potential data corruption, upgrade to this version or higher before using RewrapManyDataKey to rotate Azure-backed or GCP-backed data encryption keys. A backup of the key vault collection should always be taken before key rotation.
This release has a severe bug in the contexts returned by mongocrypt_ctx_rewrap_many_datakey_init that may result in data corruption. Please upgrade t
This release has a severe bug in the contexts returned by mongocrypt_ctx_rewrap_many_datakey_init that may result in data corruption. Please upgrade to 1.5.2 to use mongocrypt_ctx_rewrap_many_datakey_init.
This release has a severe bug in the contexts returned by mongocrypt_ctx_rewrap_many_datakey_init that may result in data corruption. Please upgrade t
This release has a severe bug in the contexts returned by mongocrypt_ctx_rewrap_many_datakey_init that may result in data corruption. Please upgrade to 1.5.2 to use mongocrypt_ctx_rewrap_many_datakey_init.
Add support for range-based Queryable Encryption with the new "rangePreview" algorithm. NOTE: The "rangePreview" algorithm is experimental only. It is not intended for public use.
Bundle libmongocrypt 1.7.0 in release wheels.
Remove support for libmongocrypt <=1.7.0, libmongocrypt >=1.7.0 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Add missing MONGOCRYPT_EXPORT to mongocrypt_ctx_provide_kms_providers
Fixed spurious exception traceback at interpreter shutdown: AttributeError: 'NoneType' object has no attribute 'mongocrypt_destroy'
Support on-demand credentials with MONGOCRYPT_CTX_NEED_KMS_CREDENTIALS state and mongocrypt_ctx_provide_kms_providers.
MONGOCRYPT_CTX_NEED_KMS_CREDENTIALS state and mongocrypt_ctx_provide_kms_providers.Bundle libmongocrypt 1.6.1 in release wheels.
Support GCP attached service accounts when using GCP KMS.
Support Azure VM-assigned Managed Identity for Automatic KMS Credentials.
Support obtaining AWS credentials for CSFLE in the same way as for MONGODB-AWS.
Fix deprecation warnings with OpenSSL 3.0.
mongocrypt_ctx_setopt_key_material.1.3.1 is a recommended upgrade for all users of 1.3.0.
Fix a potential data corruption bug in RewrapManyDataKey (ClientEncryption.rewrap_many_data_key) when rotating encrypted data encryption keys backed by GCP or Azure key services.
The following conditions will trigger this bug:
A GCP-backed or Azure-backed data encryption key being rewrapped requires fetching an access token for decryption of the data encryption key.
The result of this bug is that the key material for all data encryption keys being rewrapped is replaced by new randomly generated material, destroying the original key material.
To mitigate potential data corruption, upgrade to this version or higher before using RewrapManyDataKey to rotate Azure-backed or GCP-backed data encryption keys. A backup of the key vault collection should always be taken before key rotation.
Bundle libmongocrypt 1.5.2 in release wheels.
Remove support for libmongocrypt <=1.5.1, libmongocrypt >=1.5.2 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Support the "kmip" KMS provider.
Support the "kmip" KMS provider.
Bundle libmongocrypt 1.5.0 in release wheels.
Add support for Queryable Encryption with MongoDB 6.0.
Add support for the crypt_shared library which can be used instead of mongocryptd.
Remove support for libmongocrypt 1.3, libmongocrypt >=1.5 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Support for authentication via AWS temporary credentials.
Support for authentication via AWS temporary credentials.
Add support for the "kmip" KMS provider.
Add MongoCryptKmsContext.kms_provider property.
Bundle libmongocrypt 1.3.0 in release wheels.
Remove support for libmongocrypt 1.2, libmongocrypt >=1.3 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Fix a bug where decrypting from a memoryview was not supported.
Fix a bug where decrypting from a memoryview was not supported.
Bundle libmongocrypt 1.2.2 in release wheels.
Bundle libmongocrypt 1.2.1 in release wheels.
Bundle libmongocrypt 1.2.1 in release wheels.
Stable support for Azure/GCP KMS providers.
Stable support for Azure/GCP KMS providers.
Add support for Azure and GCP KMS providers.
Add support for temporary AWS credentials via the "sessionToken" option.
Bundle libmongocrypt 1.2.0 in release wheels.
Remove support for libmongocrypt 1.0 and 1.1, libmongocrypt >=1.2 is now required. Note this is only relevant for users that install from source or use the PYMONGOCRYPT_LIB environment variable.
Bundle libmongocrypt 1.0.4 in release wheels.
Bundle libmongocrypt 1.0.4 in release wheels.
Bundle libmongocrypt 1.0.0 in release wheels.
The first stable version.
Bundle libmongocrypt 1.0.0 in release wheels.
Add support for custom KMS endpoints with the AWS masterkey provider.
Add support for custom KMS endpoints with the AWS masterkey provider.
Bundle libmongocrypt 1.0.0 in release wheels.
Document that pip 19 is required for manylinux2010 wheel installation.
Document that pip 19 is required for manylinux2010 wheel installation.
Bundle libmongocrypt 1.0.0-beta5 in release wheels.
Make pymongocrypt compatible with manylinux2010 releases.
Make pymongocrypt compatible with manylinux2010 releases.
Bundle libmongocrypt 1.0.0-beta4 in release wheels.
Initial Python binding for libmongocrypt.
Initial Python binding for libmongocrypt.
Bundle libmongocrypt 1.0.0-beta4 in release wheels.
One column per quarter.