From baeec0225c2760172bcaace17f4c9614b78253a5 Mon Sep 17 00:00:00 2001
From: qiuluoli <158252913+qiuluoli@users.noreply.github.com>
Date: Fri, 15 May 2026 08:49:32 -0700
Subject: [PATCH 1/2] feat: add Gotify push notification provider (issue #6423)

---
 keep/providers/gotify_provider/__init__.py | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 keep/providers/gotify_provider/__init__.py

diff --git a/keep/providers/gotify_provider/__init__.py b/keep/providers/gotify_provider/__init__.py
new file mode 100644
index 0000000000..1dcf4c0791
--- /dev/null
+++ b/keep/providers/gotify_provider/__init__.py
@@ -0,0 +1 @@
+from keep.providers.gotify_provider.gotify_provider import GotifyProvider

From 03dc6688dae7d51c9a41a6f9babe10a94a7f053b Mon Sep 17 00:00:00 2001
From: qiuluoli <158252913+qiuluoli@users.noreply.github.com>
Date: Fri, 15 May 2026 08:49:35 -0700
Subject: [PATCH 2/2] feat: add Gotify provider implementation

---
 .../gotify_provider/gotify_provider.py        | 119 ++++++++++++++++++
 1 file changed, 119 insertions(+)
 create mode 100644 keep/providers/gotify_provider/gotify_provider.py

diff --git a/keep/providers/gotify_provider/gotify_provider.py b/keep/providers/gotify_provider/gotify_provider.py
new file mode 100644
index 0000000000..5fd6ebb253
--- /dev/null
+++ b/keep/providers/gotify_provider/gotify_provider.py
@@ -0,0 +1,119 @@
+"""
+Gotify provider is an interface for Gotify push notifications.
+"""
+
+import dataclasses
+import requests
+
+import pydantic
+
+from keep.contextmanager.contextmanager import ContextManager
+from keep.exceptions.provider_exception import ProviderException
+from keep.providers.base.base_provider import BaseProvider
+from keep.providers.models.provider_config import ProviderConfig
+
+
+@pydantic.dataclasses.dataclass
+class GotifyProviderAuthConfig:
+    """Gotify authentication configuration."""
+
+    url: str = dataclasses.field(
+        metadata={
+            "required": True,
+            "description": "Gotify Server URL (e.g. https://gotify.example.com)",
+        },
+        default="",
+    )
+    token: str = dataclasses.field(
+        metadata={
+            "required": True,
+            "description": "Gotify Application Token",
+            "sensitive": True,
+        },
+        default="",
+    )
+
+
+class GotifyProvider(BaseProvider):
+    """Send push notifications via self-hosted Gotify server."""
+
+    PROVIDER_DISPLAY_NAME = "Gotify"
+    PROVIDER_CATEGORY = ["Collaboration"]
+    PROVIDER_TAGS = ["alert", "notification", "self-hosted"]
+
+    def __init__(
+        self, context_manager: ContextManager, provider_id: str, config: ProviderConfig
+    ):
+        super().__init__(context_manager, provider_id, config)
+
+    def validate_config(self):
+        self.authentication_config = GotifyProviderAuthConfig(
+            **self.config.authentication
+        )
+        if not self.authentication_config.url:
+            raise ProviderException("Gotify server URL is required")
+        if not self.authentication_config.token:
+            raise ProviderException("Gotify application token is required")
+
+    def dispose(self):
+        pass
+
+    def _notify(self, **kwargs) -> dict:
+        """Send push notification to Gotify server.
+
+        Gotify API: POST /message?token=<token>
+        Body: {"title": "...", "message": "...", "priority": 5}
+        """
+        title = kwargs.get("title", "Keep Alert")
+        message = kwargs.get("message", "")
+        priority = kwargs.get("priority", 5)
+
+        if not message:
+            message = self._format_alert_message()
+
+        # Build Gotify API URL
+        url = f"{self.authentication_config.url.rstrip('/')}/message"
+        
+        # Severity to priority mapping
+        alert = self.context_manager.alert_data
+        if alert:
+            severity = alert.get("severity", "info")
+            priority_map = {
+                "critical": 10,
+                "high": 8,
+                "warning": 5,
+                "info": 3,
+                "low": 1,
+            }
+            priority = priority_map.get(severity.lower(), 5)
+
+        payload = {
+            "title": title,
+            "message": message,
+            "priority": priority,
+        }
+
+        response = requests.post(
+            url,
+            json=payload,
+            params={"token": self.authentication_config.token},
+            timeout=30,
+        )
+
+        if response.status_code != 200:
+            raise ProviderException(
+                f"Failed to send Gotify notification: {response.status_code} {response.text}"
+            )
+
+        return response.json()
+
+    def _format_alert_message(self) -> str:
+        """Format alert data into a readable message."""
+        alert = self.context_manager.alert_data
+        if not alert:
+            return "Alert notification from Keep"
+
+        name = alert.get("name", "Unknown Alert")
+        severity = alert.get("severity", "unknown")
+        description = alert.get("description", "No description")
+        return f"[{severity.upper()}] {name}: {description}"