new features

Author: Ablaze005

docs/v1.15.17/pt-BR/tools/supabase_tool.mdx

@@ -0,0 +1,26 @@
+# SupabaseTool
+
+The `SupabaseTool` allows CrewAI agents to interact with Supabase databases.
+
+## Supported Actions
+- `select`
+- `insert`
+- `update`
+- `delete`
+
+## Environment Variables
+- SUPABASE_URL
+- SUPABASE_KEY
+
+## Example Usage
+
+```python
+from crewai.tools import SupabaseTool
+
+tool = SupabaseTool()
+
+result = tool.run({
+    "action": "select",
+    "table": "messages",
+    "filters": {"id": "eq.1"}
+})

lib/crewai/pyproject.toml

@@ -45,6 +45,7 @@ dependencies = [
     "pyyaml~=6.0",
     "aiofiles~=24.1.0",
     "lancedb>=0.29.2,<0.30.1",
+    "supabase>=2.0.0",
 ]
 
 [project.urls]

lib/crewai/src/crewai/tools/supabase_tool.py

@@ -0,0 +1,75 @@
+import os
+from typing import TYPE_CHECKING, Any, Dict
+
+from crewai.tools import BaseTool
+
+if TYPE_CHECKING:
+    from supabase import Client
+
+class SupabaseTool(BaseTool):
+    name: str = "SupabaseTool"
+    description: str = (
+        "A tool for performing Supabase database operations such as "
+        "select, insert, update, and delete."
+    )
+
+    def __init__(self):
+        super().__init__()
+        url = os.getenv("SUPABASE_URL")
+        key = os.getenv("SUPABASE_KEY")
+
+        if not url or not key:
+            raise ValueError("SUPABASE_URL and SUPABASE_KEY must be set in environment variables")
+
+        from supabase import create_client
+
+        self.client: Client = create_client(url, key)
+
+    def _run(self, params: Dict[str, Any]) -> Any:
+        """
+        params example:
+        {
+            "action": "select",
+            "table": "messages",
+            "filters": {"id": "eq.1"}
+        }
+        """
+        action = params.get("action")
+        table = params.get("table")
+
+        if not action or not table:
+            return {"error": "Missing required fields: action, table"}
+
+        query = self.client.table(table)
+
+        if action == "select":
+            filters = params.get("filters", {})
+            for key, condition in filters.items():
+                query = query.eq(key, condition)
+            return query.select("*").execute()
+
+        elif action == "insert":
+            data = params.get("data")
+            if not data:
+                return {"error": "Missing data for insert"}
+            return query.insert(data).execute()
+
+        elif action == "update":
+            filters = params.get("filters", {})
+            data = params.get("data")
+            if not filters or not data:
+                return {"error": "Missing filters or data for update"}
+            for key, condition in filters.items():
+                query = query.eq(key, condition)
+            return query.update(data).execute()
+
+        elif action == "delete":
+            filters = params.get("filters", {})
+            if not filters:
+                return {"error": "Missing filters for delete"}
+            for key, condition in filters.items():
+                query = query.eq(key, condition)
+            return query.delete().execute()
+
+        else:
+            return {"error": f"Unknown action: {action}"}

lib/crewai/tests/tools/test_supabase_tool.py

@@ -0,0 +1,12 @@
+import os
+import pytest
+
+from crewai.tools.supabase_tool import SupabaseTool
+
+def test_missing_env_vars():
+    # Temporarily remove env vars
+    os.environ.pop("SUPABASE_URL", None)
+    os.environ.pop("SUPABASE_KEY", None)
+
+    with pytest.raises(ValueError):
+        SupabaseTool()

pyproject.toml

@@ -245,6 +245,7 @@ exclude-newer-package = { msgpack = "2026-06-20T00:00:00Z", pydantic-settings =
 # Keep OpenAI on the SDK range required by CrewAI when transitive dependencies
 # loosen or pin their own lower versions.
 override-dependencies = [
+    "supabase>=2.0.0",
     "openai>=2.30.0,<3",
     "rich>=13.7.1",
     "onnxruntime<1.24; python_version < '3.11'",