openhands-extensions 0.6.0__py3-none-any.whl

openhands_extensions/__init__.py

@@ -0,0 +1,24 @@
+"""Python bindings for the OpenHands extensions catalogs.
+
+Mirrors the JavaScript package (``@openhands/extensions``): both read the same
+hand-authored ``integrations/catalog/<id>.json`` files. The JavaScript package
+uses a generated static import index; the Python package loads the packaged
+individual JSON files directly. See ``integrations.py`` for the catalog API,
+including filtering by connector type (mcp / oauth).
+"""
+
+from __future__ import annotations
+
+from ._version import __version__
+from .integrations import (
+    INTEGRATION_CATALOG_SNAPSHOT,
+    get_integration_catalog_entry,
+    list_integration_catalog,
+)
+
+__all__ = [
+    "INTEGRATION_CATALOG_SNAPSHOT",
+    "__version__",
+    "get_integration_catalog_entry",
+    "list_integration_catalog",
+]

openhands_extensions/_version.py

@@ -0,0 +1,24 @@
+"""Package version, derived from installed package metadata.
+
+The single source of truth is ``pyproject.toml``'s ``[project].version``
+(which ``release-please`` bumps together with ``package.json`` via
+``release-please-config.json`` -> ``extra-files``). At runtime we read the
+installed distribution metadata via ``importlib.metadata`` so there is no
+second hand-maintained version string. ``_FALLBACK_VERSION`` is only used
+when the package is imported without being installed (e.g. straight off a
+source checkout with no build), and ``tests/test_version_alignment.py``
+asserts it stays in lock-step with ``pyproject.toml`` / ``package.json``.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+#: Fallback used only when the package is not installed (no dist metadata).
+#: Kept in lock-step with pyproject.toml/package.json by the version test.
+_FALLBACK_VERSION = "0.6.0"
+
+try:
+    __version__: str = version("openhands-extensions")
+except PackageNotFoundError:  # not installed (e.g. raw source checkout)
+    __version__ = _FALLBACK_VERSION

openhands_extensions/catalog/airtable.json

@@ -0,0 +1,74 @@
+{
+  "id": "airtable",
+  "name": "Airtable",
+  "description": "List bases, query records, and update fields across your Airtable workspace.",
+  "categories": [
+    "Database",
+    "Operations"
+  ],
+  "appUrl": "https://airtable.com",
+  "docsUrl": "https://github.com/domdomegg/airtable-mcp-server",
+  "notes": "Very common internal-tools and operations automation surface.",
+  "popularityRank": 17,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://airtable.com/oauth2/v1/authorize",
+          "tokenUrl": "https://airtable.com/oauth2/v1/token",
+          "scopes": [
+            "schema.bases:read",
+            "data.records:read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.airtable.com/v0",
+        "defaultTool": {
+          "name": "list_bases",
+          "description": "List Airtable bases the connected user granted access to.",
+          "method": "GET",
+          "path": "/meta/bases"
+        }
+      }
+    },
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "airtable",
+        "command": "npx",
+        "args": [
+          "-y",
+          "airtable-mcp-server"
+        ],
+        "envFields": [
+          {
+            "key": "AIRTABLE_API_KEY",
+            "label": "Airtable personal access token",
+            "type": "password",
+            "required": true,
+            "helperText": "Personal access token from your Airtable account.",
+            "helperLink": "https://airtable.com/create/tokens"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ],
+  "iconBg": "#FCB400",
+  "logoUrl": "https://cdn.simpleicons.org/airtable/000000",
+  "iconColor": "var(--oh-surface-deep)",
+  "keywords": [
+    "spreadsheet",
+    "database",
+    "records",
+    "bases"
+  ]
+}

openhands_extensions/catalog/apify.json

@@ -0,0 +1,41 @@
+{
+  "id": "apify",
+  "name": "Apify Actors",
+  "description": "Run any of Apify's 5,000+ Actors (scrapers, automations) from the agent.",
+  "docsUrl": "https://docs.apify.com/platform/integrations/mcp",
+  "iconBg": "#10b981",
+  "keywords": [
+    "scraping",
+    "automation",
+    "crawl",
+    "actors"
+  ],
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "apify",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@apify/actors-mcp-server"
+        ],
+        "envFields": [
+          {
+            "key": "APIFY_TOKEN",
+            "label": "Apify token",
+            "type": "password",
+            "required": true,
+            "helperText": "API token from your Apify account settings.",
+            "helperLink": "https://console.apify.com/account/integrations"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/asana.json

@@ -0,0 +1,38 @@
+{
+  "id": "asana",
+  "name": "Asana",
+  "description": "Task management, projects, and work tracking.",
+  "categories": [
+    "Project management",
+    "Operations"
+  ],
+  "appUrl": "https://asana.com",
+  "docsUrl": "https://developers.asana.com/docs/oauth",
+  "notes": "Broad business adoption and straightforward OAuth app model.",
+  "popularityRank": 13,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://app.asana.com/-/oauth_authorize",
+          "tokenUrl": "https://app.asana.com/-/oauth_token",
+          "scopes": [
+            "tasks:read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://app.asana.com/api/1.0",
+        "defaultTool": {
+          "name": "list_tasks",
+          "description": "List tasks visible to the connected Asana user.",
+          "method": "GET",
+          "path": "/tasks"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/atlassian.json

@@ -0,0 +1,28 @@
+{
+  "id": "atlassian",
+  "name": "Atlassian (Jira & Confluence)",
+  "description": "Search Jira issues and Confluence pages via Atlassian's hosted MCP server.",
+  "docsUrl": "https://www.atlassian.com/platform/remote-mcp-server",
+  "iconBg": "#0052CC",
+  "logoUrl": "https://cdn.simpleicons.org/atlassian/FFFFFF",
+  "keywords": [
+    "jira",
+    "confluence",
+    "tickets",
+    "wiki",
+    "issues"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.atlassian.com/v1/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/bitbucket.json

@@ -0,0 +1,39 @@
+{
+  "id": "bitbucket",
+  "name": "Bitbucket",
+  "description": "Repositories, pull requests, and Atlassian engineering workflows.",
+  "categories": [
+    "Engineering",
+    "Source control"
+  ],
+  "appUrl": "https://bitbucket.org",
+  "docsUrl": "https://developer.atlassian.com/cloud/bitbucket/oauth-2/",
+  "notes": "Popular in Atlassian-centric teams and complements Jira/Confluence.",
+  "popularityRank": 50,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://bitbucket.org/site/oauth2/authorize",
+          "tokenUrl": "https://bitbucket.org/site/oauth2/access_token",
+          "scopes": [
+            "account",
+            "repository"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.bitbucket.org/2.0",
+        "defaultTool": {
+          "name": "get_current_user",
+          "description": "Fetch the authenticated Bitbucket user profile.",
+          "method": "GET",
+          "path": "/user"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/box.json

@@ -0,0 +1,39 @@
+{
+  "id": "box",
+  "name": "Box",
+  "description": "Enterprise file storage, metadata, and collaboration.",
+  "categories": [
+    "Storage",
+    "Enterprise"
+  ],
+  "appUrl": "https://www.box.com",
+  "docsUrl": "https://developer.box.com/guides/authentication/oauth2/",
+  "notes": "Strong enterprise document-management footprint.",
+  "popularityRank": 19,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://account.box.com/api/oauth2/authorize",
+          "tokenUrl": "https://api.box.com/oauth2/token",
+          "scopes": [
+            "root_readonly",
+            "item_read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.box.com/2.0",
+        "defaultTool": {
+          "name": "list_root_items",
+          "description": "List files and folders in the Box root folder.",
+          "method": "GET",
+          "path": "/folders/0/items"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/brave-search.json

@@ -0,0 +1,42 @@
+{
+  "id": "brave-search",
+  "name": "Brave Search",
+  "description": "Privacy-first web and local search using the Brave Search API.",
+  "docsUrl": "https://github.com/brave/brave-search-mcp-server",
+  "iconBg": "#FB542B",
+  "logoUrl": "https://cdn.simpleicons.org/brave/FFFFFF",
+  "keywords": [
+    "search",
+    "web"
+  ],
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "brave_search",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@brave/brave-search-mcp-server",
+          "--transport",
+          "stdio"
+        ],
+        "envFields": [
+          {
+            "key": "BRAVE_API_KEY",
+            "label": "Brave API key",
+            "type": "password",
+            "required": true,
+            "helperText": "API key from the Brave Search API portal.",
+            "helperLink": "https://api-dashboard.search.brave.com/app/keys"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/browser-mcp.json

@@ -0,0 +1,31 @@
+{
+  "id": "browser-mcp",
+  "name": "Browser MCP",
+  "description": "Control your local browser tab — navigate, click, type, and read DOM contents.",
+  "docsUrl": "https://browsermcp.io/",
+  "iconBg": "#0EA5E9",
+  "keywords": [
+    "browser",
+    "automation",
+    "chrome",
+    "playwright"
+  ],
+  "connectionOptions": [
+    {
+      "id": "none",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "browser_mcp",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@browsermcp/mcp"
+        ]
+      },
+      "auth": {
+        "strategy": "none"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/canva.json

@@ -0,0 +1,35 @@
+{
+  "id": "canva",
+  "name": "Canva",
+  "description": "Design content, brand assets, and marketing collateral workflows.",
+  "categories": [
+    "Design",
+    "Marketing"
+  ],
+  "appUrl": "https://www.canva.com",
+  "docsUrl": "https://www.canva.dev/docs/connect/oauth/",
+  "notes": "Broad creator and marketing adoption with OAuth-based apps.",
+  "popularityRank": 34,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "tokenUrl": "https://api.canva.com/rest/v1/oauth/token",
+          "scopes": []
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.canva.com/rest/v1",
+        "defaultTool": {
+          "name": "list_designs",
+          "description": "List Canva designs available to the connected user.",
+          "method": "GET",
+          "path": "/designs"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/clickhouse.json

@@ -0,0 +1,55 @@
+{
+  "id": "clickhouse",
+  "name": "ClickHouse",
+  "description": "Run analytical SQL queries against a ClickHouse cluster.",
+  "docsUrl": "https://github.com/ClickHouse/mcp-clickhouse",
+  "iconBg": "#FFFF00",
+  "logoUrl": "https://cdn.simpleicons.org/clickhouse/000000",
+  "iconColor": "var(--oh-surface-deep)",
+  "keywords": [
+    "analytics",
+    "olap",
+    "database",
+    "sql"
+  ],
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "clickhouse",
+        "command": "uvx",
+        "args": [
+          "mcp-clickhouse"
+        ],
+        "envFields": [
+          {
+            "key": "CLICKHOUSE_HOST",
+            "label": "Host",
+            "type": "text",
+            "placeholder": "clickhouse.example.com",
+            "required": true
+          },
+          {
+            "key": "CLICKHOUSE_USER",
+            "label": "Username",
+            "type": "text",
+            "required": true
+          },
+          {
+            "key": "CLICKHOUSE_PASSWORD",
+            "label": "Password",
+            "type": "password",
+            "required": true,
+            "helperText": "Password for your ClickHouse user.",
+            "helperLink": "https://clickhouse.com/docs/operations/access-rights"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/clickup.json

@@ -0,0 +1,36 @@
+{
+  "id": "clickup",
+  "name": "ClickUp",
+  "description": "Tasks, docs, goals, and workflow automation.",
+  "categories": [
+    "Project management",
+    "Operations"
+  ],
+  "appUrl": "https://clickup.com",
+  "docsUrl": "https://clickup.com/api/developer-portal/authentication",
+  "notes": "Large install base and broad operations coverage.",
+  "popularityRank": 15,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://app.clickup.com/api",
+          "tokenUrl": "https://api.clickup.com/api/v2/oauth/token",
+          "scopes": []
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.clickup.com/api/v2",
+        "defaultTool": {
+          "name": "list_workspaces",
+          "description": "List ClickUp workspaces available to the connected user.",
+          "method": "GET",
+          "path": "/team"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/cloudflare-bindings.json

@@ -0,0 +1,29 @@
+{
+  "id": "cloudflare-bindings",
+  "name": "Cloudflare Workers Bindings",
+  "description": "Inspect and manage KV, D1, R2, and Durable Object bindings on your Cloudflare account.",
+  "docsUrl": "https://developers.cloudflare.com/agents/model-context-protocol/",
+  "iconBg": "#F38020",
+  "logoUrl": "https://cdn.simpleicons.org/cloudflare/FFFFFF",
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "kv",
+    "d1",
+    "r2",
+    "durable objects"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://bindings.mcp.cloudflare.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/cloudflare-browser-rendering.json

@@ -0,0 +1,27 @@
+{
+  "id": "cloudflare-browser-rendering",
+  "name": "Cloudflare Browser Rendering",
+  "description": "Fetch and screenshot pages using Cloudflare's hosted browser rendering.",
+  "docsUrl": "https://developers.cloudflare.com/agents/model-context-protocol/",
+  "iconBg": "#F38020",
+  "logoUrl": "https://cdn.simpleicons.org/cloudflare/FFFFFF",
+  "keywords": [
+    "cloudflare",
+    "browser",
+    "rendering",
+    "screenshots"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://browser.mcp.cloudflare.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/cloudflare-builds.json

@@ -0,0 +1,28 @@
+{
+  "id": "cloudflare-builds",
+  "name": "Cloudflare Builds",
+  "description": "Inspect Workers Builds \u2014 logs, statuses, and rerun failed deploys.",
+  "docsUrl": "https://developers.cloudflare.com/agents/model-context-protocol/",
+  "iconBg": "#F38020",
+  "logoUrl": "https://cdn.simpleicons.org/cloudflare/FFFFFF",
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "ci",
+    "builds",
+    "deploys"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://builds.mcp.cloudflare.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/cloudflare-docs.json

@@ -0,0 +1,27 @@
+{
+  "id": "cloudflare-docs",
+  "name": "Cloudflare Docs",
+  "description": "Search and reference Cloudflare's developer documentation directly from the agent.",
+  "docsUrl": "https://developers.cloudflare.com/agents/model-context-protocol/",
+  "iconBg": "#F38020",
+  "logoUrl": "https://cdn.simpleicons.org/cloudflare/FFFFFF",
+  "keywords": [
+    "cloudflare",
+    "docs",
+    "reference",
+    "workers"
+  ],
+  "connectionOptions": [
+    {
+      "id": "none",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://docs.mcp.cloudflare.com/mcp"
+      },
+      "auth": {
+        "strategy": "none"
+      }
+    }
+  ]
+}

openhands_extensions/catalog/cloudflare-observability.json

@@ -0,0 +1,28 @@
+{
+  "id": "cloudflare-observability",
+  "name": "Cloudflare Observability",
+  "description": "Tail Workers logs and query observability data from your Cloudflare account.",
+  "docsUrl": "https://developers.cloudflare.com/agents/model-context-protocol/",
+  "iconBg": "#F38020",
+  "logoUrl": "https://cdn.simpleicons.org/cloudflare/FFFFFF",
+  "keywords": [
+    "cloudflare",
+    "logs",
+    "tail",
+    "observability",
+    "workers"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://observability.mcp.cloudflare.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    }
+  ]
+}