diff --git a/examples/gallery/seismology/meca.py b/examples/gallery/seismology/meca.py
index e55fdd6d7df..5553c42ff29 100644
--- a/examples/gallery/seismology/meca.py
+++ b/examples/gallery/seismology/meca.py
@@ -9,6 +9,11 @@
 compressive and extensive quadrants can be filled either with a color or a pattern via
 the ``compression_fill`` and ``extension_fill`` parameters, respectively. Use the
 ``pen`` parameter to adjust the outline of the beachballs.
+
+For GMT 6.7.0, a colormap set up via ``pygmt.makecpt`` and applied as ``cmap=True``
+is ignored. For details, please see the upstream GMT
+[issue 9176](https://github.com/GenericMappingTools/gmt/issues/9176) and
+[PR 9177](https://github.com/GenericMappingTools/gmt/pull/9177).
 """
 
 # %%
diff --git a/examples/tutorials/advanced/focal_mechanisms.py b/examples/tutorials/advanced/focal_mechanisms.py
index abd6a090c35..75470d7858f 100644
--- a/examples/tutorials/advanced/focal_mechanisms.py
+++ b/examples/tutorials/advanced/focal_mechanisms.py
@@ -303,6 +303,11 @@
 # ``depth``, e.g., by moment magnitude or hypocentral depth, respectively. Use the
 # parameter ``cmap`` to pass the desired colormap. Now, the fills of the small circles
 # indicating the event locations are given by the colormap.
+#
+# For GMT 6.7.0, a colormap set up via ``pygmt.makecpt`` and applied as ``cmap=True``
+# is ignored. For details, please see the upstream GMT
+# [issue 9176](https://github.com/GenericMappingTools/gmt/issues/9176) and
+# [PR 9177](https://github.com/GenericMappingTools/gmt/pull/9177).
 
 fig = pygmt.Figure()
 fig.coast(region="d", projection="N10c", land="lightgray", frame=True)
diff --git a/pygmt/src/meca.py b/pygmt/src/meca.py
index a2c84cd641a..d9a0c5486f5 100644
--- a/pygmt/src/meca.py
+++ b/pygmt/src/meca.py
@@ -337,6 +337,13 @@ def meca(
         automatically. The color of the compressive quadrants is determined by the
         z-value (i.e., event depth or the third column for an input file). This setting
         also applies to the fill of the circle defined via ``offset``.
+
+        .. note::
+           For GMT 6.7.0, a colormap set up via ``pygmt.makecpt`` and applied as
+           ``cmap=True`` is ignored. For details, please see the upstream GMT
+           [issue 9176](https://github.com/GenericMappingTools/gmt/issues/9176) and
+           [PR 9177](https://github.com/GenericMappingTools/gmt/pull/9177).
+
     no_clip
         Do **not** skip symbols that fall outside the frame boundaries [Default is
         ``False``, i.e., plot symbols inside the frame boundaries only].