diff --git a/doxygen/microservices.cpp b/doxygen/microservices.cpp
index b2780bb99e..8d71f68526 100644
--- a/doxygen/microservices.cpp
+++ b/doxygen/microservices.cpp
@@ -112,7 +112,7 @@
   - #msiSubstr   - Returns a substring of the given string
 
  \subsection msiemail Email Microservices
-  - #msiSendMail   - Sends email
+  - #msiSendMail   - (Deprecated) Sends email
 
  \subsection msikv Key-Value (Attr-Value) Microservices
   - #writeKeyValPairs - Writes key-value pairs to stdout or stderr and with given separator
diff --git a/server/re/src/mailMS.cpp b/server/re/src/mailMS.cpp
index a001e84fed..dd2d1983ce 100644
--- a/server/re/src/mailMS.cpp
+++ b/server/re/src/mailMS.cpp
@@ -14,12 +14,16 @@
  *
  * \brief Sends email
  *
+ * This microservice is deprecated and will be removed in a later release. Consider using the Python rule engine plugin
+ * or exposing your own mail utility via msiExecCmd.
+ *
  * \module core
  *
  * \since pre-2.1
  *
  *
- * \note   This microservice sends e-mail using the mail command in the unix system. No attachments are supported. The sender of the e-mail is the unix user-id running the irodsServer.
+ * \note   This microservice sends e-mail using the mail command in the unix system. No attachments are supported. The
+ * sender of the e-mail is the unix user-id running the irodsServer.
  *
  * \usage See clients/icommands/test/rules/
  *
@@ -41,7 +45,7 @@
  * \pre none
  * \post none
  * \sa none
-**/
+ **/
 int msiSendMail( msParam_t* xtoAddr, msParam_t* xsubjectLine, msParam_t* xbody, ruleExecInfo_t* ) {
 
     const char * toAddr = ( char * ) xtoAddr->inOutStruct;