diff --git a/README.md b/README.md
index d759645..3c095af 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ pip install omop-cdm
 
 ## Usage
 
-See [User documentation](docs/README.md)
+See [User documentation](https://github.com/thehyve/omop-cdm/blob/main/docs/README.md)
 
 ## Supported databases
 The omop-cdm table definitions are tested to be compatible with PostgreSQL.
diff --git a/pyproject.toml b/pyproject.toml
index 010ce85..08531cf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -20,6 +20,10 @@ classifiers = [
     "Programming Language :: Python :: Implementation :: CPython",
 ]
 
+[tool.poetry.urls]
+"Repository" = "https://github.com/thehyve/omop-cdm"
+"Documentation" = "https://github.com/thehyve/omop-cdm/blob/main/docs/README.md"
+
 [tool.poetry.dependencies]
 python = "^3.9"
 sqlalchemy = "^2.0.4"