diff --git a/stubs/usersettings/@tests/stubtest_allowlist.txt b/stubs/usersettings/@tests/stubtest_allowlist.txt
new file mode 100644
index 000000000..be5153524
--- /dev/null
+++ b/stubs/usersettings/@tests/stubtest_allowlist.txt
@@ -0,0 +1,3 @@
+usersettings.Settings.app_id
+usersettings.Settings.settings_directory
+usersettings.Settings.settings_file
diff --git a/stubs/usersettings/METADATA.toml b/stubs/usersettings/METADATA.toml
new file mode 100644
index 000000000..2f8a7161b
--- /dev/null
+++ b/stubs/usersettings/METADATA.toml
@@ -0,0 +1,2 @@
+version = "1.1.*"
+upstream_repository = "https://github.com/glvnst/usersettings"
diff --git a/stubs/usersettings/usersettings.pyi b/stubs/usersettings/usersettings.pyi
new file mode 100644
index 000000000..28599de1d
--- /dev/null
+++ b/stubs/usersettings/usersettings.pyi
@@ -0,0 +1,14 @@
+from typing import Any, TypeVar
+
+_S = TypeVar("_S")
+
+class Settings(dict[str, Any]):
+    app_id: str
+    settings_directory: str
+    settings_file: str
+    def __init__(self, app_id: str) -> None: ...
+    def add_setting(self, setting_name: str, setting_type: type[_S] = ..., default: _S | None = None) -> None: ...
+    def load_settings(self) -> None: ...
+    def save_settings(self) -> None: ...
+    def __getattr__(self, setting_name: str) -> Any: ...
+    def __setattr__(self, setting_name: str, setting_value: Any) -> None: ...