diff --git a/README.md b/README.md
index 813b2ff..5a92478 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
 # aerc-contacts
 
-Search macOS Contacts and output data for aerc email client
\ No newline at end of file
+Search macOS Contacts and output data for aerc email client
+
+## Installation
+```shell script
+make install
+```
+
+## Usage
+```shell script
+aerc-contacts John Doe
+```
+
+This will output all emails and contact names matching "John" and "Doe"
+in either the first name, last name or email fields.