diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# mackerel-client-hs [![Build Status](https://travis-ci.org/itchyny/mackerel-client-hs.png?branch=master)](https://travis-ci.org/itchyny/mackerel-client-hs)
+An API client library for [Mackerel](https://mackerel.io).
+
+API documents: [Mackerel API Documents (v0)](https://mackerel.io/api-docs/)
+
+The official Go client library: [mackerel-client-go](https://github.com/mackerelio/mackerel-client-go)
+
+## Example
+```haskell
+import Data.Default
+import Web.Mackerel
+
+main :: IO ()
+main = do
+  let client = def { apiKey = "<Mackerel-API-KEY>" }
+
+  print =<< getOrganization client
+  print =<< listUsers client
+
+  print =<< listHosts client def { listHostsParamsService = Just "servicename", listHostsParamsRoles = ["role1", "role2"] }
+
+  print =<< listMonitors client
+  print =<< updateMonitor client monitor { monitorName = "Monitor name renamed" }
+  print =<< deleteMonitor client (MonitorId "<Monitor-ID>")
+
+  print =<< listAlerts client
+  print =<< closeAlert client (AlertId "<Alert-ID>") "this is not an important alert"
+```
+
+## Author
+itchyny (https://github.com/itchyny)
+
+## License
+This software is released under the MIT License, see LICENSE.
diff --git a/mackerel-client.cabal b/mackerel-client.cabal
--- a/mackerel-client.cabal
+++ b/mackerel-client.cabal
@@ -1,5 +1,5 @@
 name:                   mackerel-client
-version:                0.0.0
+version:                0.0.1
 author:                 itchyny
 maintainer:             itchyny <https://github.com/itchyny>
 license:                MIT
@@ -12,6 +12,7 @@
                         .
                         The official site of Mackerel: https://mackerel.io/.
                         The reference of Mackerel API: https://mackerel.io/api-docs/.
+extra-source-files:     README.md
 
 library
   hs-source-dirs:       src