diff --git a/connectivity/FEATURE_BLE/include/ble/services/BatteryService.h b/connectivity/FEATURE_BLE/include/ble/services/BatteryService.h
index 7c44e35cbe8..7927bb5e84c 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/BatteryService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/BatteryService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef MBED_BLE_BATTERY_SERVICE_H__
 #define MBED_BLE_BATTERY_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/DeviceInformationService.h b/connectivity/FEATURE_BLE/include/ble/services/DeviceInformationService.h
index d021a06fd92..fca6084e819 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/DeviceInformationService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/DeviceInformationService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef __BLE_DEVICE_INFORMATION_SERVICE_H__
 #define __BLE_DEVICE_INFORMATION_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/EnvironmentalService.h b/connectivity/FEATURE_BLE/include/ble/services/EnvironmentalService.h
index fdb5bf7b115..71cf7d60946 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/EnvironmentalService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/EnvironmentalService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef __BLE_ENVIRONMENTAL_SERVICE_H__
 #define __BLE_ENVIRONMENTAL_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/HealthThermometerService.h b/connectivity/FEATURE_BLE/include/ble/services/HealthThermometerService.h
index 6e946baaea6..b5a680e3a44 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/HealthThermometerService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/HealthThermometerService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef __BLE_HEALTH_THERMOMETER_SERVICE_H__
 #define __BLE_HEALTH_THERMOMETER_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/HeartRateService.h b/connectivity/FEATURE_BLE/include/ble/services/HeartRateService.h
index 405aaf9290a..5b87f6eae71 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/HeartRateService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/HeartRateService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef MBED_BLE_HEART_RATE_SERVICE_H__
 #define MBED_BLE_HEART_RATE_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/LinkLossService.h b/connectivity/FEATURE_BLE/include/ble/services/LinkLossService.h
index ded7fafcaea..810834630e9 100644
--- a/connectivity/FEATURE_BLE/include/ble/services/LinkLossService.h
+++ b/connectivity/FEATURE_BLE/include/ble/services/LinkLossService.h
@@ -16,6 +16,9 @@
  * limitations under the License.
  */
 
+/* MBED_DEPRECATED */
+#warning "These services are deprecated and will be removed. Please see services.md for details about replacement services."
+
 #ifndef __BLE_LINK_LOSS_SERVICE_H__
 #define __BLE_LINK_LOSS_SERVICE_H__
 
diff --git a/connectivity/FEATURE_BLE/include/ble/services/services.md b/connectivity/FEATURE_BLE/include/ble/services/services.md
new file mode 100644
index 00000000000..faae8337052
--- /dev/null
+++ b/connectivity/FEATURE_BLE/include/ble/services/services.md
@@ -0,0 +1,13 @@
+# Mbed OS BLE services
+
+BLE services are available in the https://github.com/ARMmbed/mbed-os-experimental-ble-services repository. It's a
+community effort and contains services created by mbed-os team, our partners and mbed-os users. 
+
+To use the services there add the repository to your project by adding a 'mbed-os-experimental-ble-services.lib' file
+containing the link to the repo like so:
+```
+https://github.com/ARMmbed/mbed-os-experimental-ble-services
+```
+
+Each BLE service is an Mbed OS library.  To use it with new cmake based mbed-tools you will need to add the library
+to your link libraries for your application.