diff --git a/README.md b/README.md
index f1c66f275..3622cc50e 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,8 @@ The necessary bits are:
 
 Downstream consumers may use either the static or dynamic library, as they prefer.
 
+NOTE: on Windows, the "BCrypt" library must be included when linking to taskchampion.
+
 ## Documentation Generation
 
 The `mdbook` configuration contains a "preprocessor" implemented in the `taskchampion-cli` crate in order to reflect CLI usage information into the generated book.
diff --git a/integration-tests/build.rs b/integration-tests/build.rs
index 8369b57a7..90165f6d0 100644
--- a/integration-tests/build.rs
+++ b/integration-tests/build.rs
@@ -19,6 +19,11 @@ fn link_libtaskchampion() {
     let libtc_dir = libtc_dir.to_str().expect("path is valid utf-8");
     println!("cargo:rustc-link-search={}", libtc_dir);
     println!("cargo:rustc-link-lib=dylib=taskchampion");
+
+    // on windows, it appears that rust std requires BCrypt
+    if cfg!(target_os = "windows") {
+        println!("cargo:rustc-link-lib=dylib=bcrypt");
+    }
 }
 
 /// Build the Unity-based C test suite in `src/bindings_tests`, linking the result with this