1diff --git a/plugins/mysql-macports/README.md b/plugins/mysql-macports/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..a4224d9c0f4fbb29c8079608eb6523c5d39dfb79
4--- /dev/null
5+++ b/plugins/mysql-macports/README.md
6@@ -0,0 +1,20 @@
7+# MySQL-Macports plugin
8+
9+This plugin adds aliases for some of the commonly used [MySQL](https://www.mysql.com/) commands when installed using [MacPorts](https://www.macports.org/) on macOS.
10+
11+To use it, add `mysql-macports` to the plugins array in your zshrc file:
12+
13+```zsh
14+plugins=(... mysql-macports)
15+```
16+
17+For instructions on how to install MySQL using MacPorts, read the [MacPorts wiki](https://trac.macports.org/wiki/howto/MySQL/).
18+
19+## Aliases
20+
21+| Alias | Command | Description |
22+| ------------ | --------------------------------------------------------- | ------------------------------------------ |
23+| mysqlstart | `sudo /opt/local/share/mysql5/mysql/mysql.server start` | Start the MySQL server. |
24+| mysqlstop | `sudo /opt/local/share/mysql5/mysql/mysql.server stop` | Stop the MySQL server. |
25+| mysqlrestart | `sudo /opt/local/share/mysql5/mysql/mysql.server restart` | Restart the MySQL server. |
26+| mysqlstatus | `mysqladmin5 -u root -p ping` | Check whether the MySQL server is running. |