@openhands/extensions 0.6.0 → 0.7.0

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.0"
+  ".": "0.7.0"
 }

package/README.md

@@ -59,9 +59,9 @@ See [`integrations/README.md`](integrations/README.md), [`automations/README.md`
 
 ### Python Package
 
-The integration catalog is also published as a Python package (`openhands-extensions`) so Python services read the same catalog data as JS consumers. The single source of truth is the hand-authored JSON asset `integrations/integration-catalog.json` (NOT generated from any `.mjs`/`.js` source). Each per-integration entry also exists as `integrations/catalog/<id>.json`; a CI parity test asserts the two never drift. Both the JS package (`@openhands/extensions/integrations`) and the Python package read that same JSON asset at runtime, so the two language bindings can never drift.
+The integration catalog is also published as a Python package (`openhands-extensions`) so Python services read the same catalog data as JS consumers. The single source of truth is the hand-authored JSON directory `integrations/catalog/<id>.json`; there is no separate provider file and no aggregate catalog JSON to maintain. Both the JS package (`@openhands/extensions/integrations`) and the Python package read those same per-integration JSON files and expose parallel read functions.
 
-The catalog is one array where each entry can carry oauth and/or mcp/http `connectionOptions`. `supportsOauth` / `supportsMcp` flags are derived at runtime. Use `listIntegrationCatalog({ mcp, oauth })` (JS) or `list_integration_catalog(mcp=, oauth=)` (Python) to filter by connector type - for example only integrations that support an oauth connector.
+Each catalog entry can carry oauth and/or mcp/http `connectionOptions`. `supportsOauth` / `supportsMcp` flags are derived at runtime. Use `listIntegrationCatalog({ mcp, oauth })` (JS) or `list_integration_catalog(mcp=, oauth=)` (Python) to filter by connector type - for example only integrations that support an oauth connector.
 
 ```python
 from openhands_extensions import (
@@ -73,7 +73,7 @@ from openhands_extensions import (
 all_integrations = list_integration_catalog()
 oauth_integrations = list_integration_catalog(oauth=True)      # only entries with an oauth connector
 mcp_integrations = list_integration_catalog(mcp=True)          # only entries with an mcp connector
-hubspot = get_integration_catalog_entry("hubspot")
+sample = get_integration_catalog_entry(all_integrations[0]["id"])
 ```
 
 Install from git (the hub backend consumes it this way):
@@ -87,7 +87,7 @@ The JS and Python versions are kept in lock-step by `release-please` and guarded
 ## Extensions Catalog
 
 <!-- BEGIN AUTO-GENERATED CATALOG -->
-This repository contains **2 marketplace(s)** with **58 extensions** (48 skills, 10 plugins).
+This repository contains **2 marketplace(s)** with **60 extensions** (50 skills, 10 plugins).
 
 ### large-codebase
 
@@ -106,7 +106,7 @@ OpenHands skills for interacting, improving, and refactoring large codebases
 
 Official skills and plugins for OpenHands — the open-source AI software engineer.
 
-**54 extensions** (46 skills, 8 plugins)
+**56 extensions** (48 skills, 8 plugins)
 
 | Name | Type | Description | Commands |
 |------|------|-------------|----------|
@@ -116,7 +116,9 @@ Official skills and plugins for OpenHands — the open-source AI software engine
 | agent-memory | skill | Persist and retrieve repository-specific knowledge using AGENTS.md files. Use when you want to save important informa... | `/remember` |
 | agent-sdk-builder | skill | Guided workflow for building custom AI agents using the OpenHands Software Agent SDK. Use when you want to create a n... | `/agent-builder` |
 | azure-devops | skill | Interact with Azure DevOps repositories, pull requests, and APIs using the AZURE_DEVOPS_TOKEN environment variable. U... | — |
-| bitbucket | skill | Interact with Bitbucket repositories and pull requests using the BITBUCKET_TOKEN environment variable. Use when worki... | — |
+| bitbucket | skill | Bitbucket integration hub. Detects whether the repository is on Bitbucket Cloud or Bitbucket Data Center and directs ... | — |
+| bitbucket-cloud | skill | Bitbucket Cloud (bitbucket.org) specifics — authenticate with BITBUCKET_TOKEN, use the REST API v2, workspace/repo_sl... | — |
+| bitbucket-data-center | skill | Bitbucket Data Center (self-hosted Bitbucket Server) specifics — authenticate with BITBUCKET_DATA_CENTER_TOKEN, use t... | — |
 | city-weather | plugin | Get current weather, time, and precipitation forecast for any city using the free Open-Meteo API. Provides slash comm... | — |
 | code-review | skill | Rigorous code review focusing on data structures, simplicity, security, pragmatism, and risk/safety evaluation. Provi... | `/codereview`, `/codereview-roasted` |
 | code-simplifier | skill | Simplifies and refines code across three dimensions - code reuse, code quality, and efficiency - while preserving all... | `/simplify` |

package/integrations/README.md

@@ -18,10 +18,16 @@ integrations so clients can consume one source of truth.
 Each integration carries its OAuth/MCP connection data directly. Do not add a
 separate provider catalog or per-language provider data.
 
-Consumers can import the package export:
+Consumers should use the read functions exported by the package:
 
 ```js
-import { INTEGRATION_CATALOG } from "@openhands/extensions/integrations";
+import {
+  getIntegrationCatalogEntry,
+  listIntegrationCatalog,
+} from "@openhands/extensions/integrations";
+
+const catalog = listIntegrationCatalog();
+const entry = getIntegrationCatalogEntry(catalog[0].id);
 ```
 
 ## Migration from the MCP catalog

package/integrations/catalog/airtable.json

@@ -11,30 +11,6 @@
   "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",

package/integrations/catalog/asana.json

@@ -26,12 +26,7 @@
       },
       "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"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/asana.com/1.0/openapi.json"
       }
     }
   ]

package/integrations/catalog/bitbucket.json

@@ -27,12 +27,7 @@
       },
       "http": {
         "apiBaseUrl": "https://api.bitbucket.org/2.0",
-        "defaultTool": {
-          "name": "get_current_user",
-          "description": "Fetch the authenticated Bitbucket user profile.",
-          "method": "GET",
-          "path": "/user"
-        }
+        "openApiUrl": "https://developer.atlassian.com/cloud/bitbucket/swagger.v3.json"
       }
     }
   ]

package/integrations/catalog/box.json

@@ -27,12 +27,7 @@
       },
       "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"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/box/box-openapi/main/openapi.json"
       }
     }
   ]

package/integrations/catalog/canva.json

@@ -18,17 +18,13 @@
         "strategy": "oauth2",
         "oauth": {
           "tokenUrl": "https://api.canva.com/rest/v1/oauth/token",
-          "scopes": []
+          "scopes": [],
+          "authorizationUrl": "https://www.canva.com/api/oauth/authorize"
         }
       },
       "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"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/canva-sdks/canva-connect-api-starter-kit/main/openapi/spec.yml"
       }
     }
   ]

package/integrations/catalog/confluence.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://api.atlassian.com/ex/confluence/{cloudId}",
-        "defaultTool": {
-          "name": "list_spaces",
-          "description": "List Confluence spaces available to the connected user.",
-          "method": "GET",
-          "path": "/wiki/api/v2/spaces"
-        }
+        "openApiUrl": "https://developer.atlassian.com/cloud/confluence/swagger.v3.json"
       }
     }
   ]

package/integrations/catalog/discord.json

@@ -27,12 +27,7 @@
       },
       "http": {
         "apiBaseUrl": "https://discord.com/api/v10",
-        "defaultTool": {
-          "name": "list_guilds",
-          "description": "List Discord guilds available to the connected user.",
-          "method": "GET",
-          "path": "/users/@me/guilds"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json"
       }
     }
   ]

package/integrations/catalog/figma.json

@@ -8,35 +8,8 @@
   ],
   "appUrl": "https://www.figma.com",
   "docsUrl": "https://github.com/GLips/Figma-Context-MCP",
-  "notes": "",
   "popularityRank": 5,
   "connectionOptions": [
-    {
-      "id": "oauth",
-      "provider": "http",
-      "auth": {
-        "strategy": "oauth2",
-        "oauth": {
-          "authorizationUrl": "https://www.figma.com/oauth",
-          "tokenUrl": "https://api.figma.com/v1/oauth/token",
-          "scopes": [
-            "current_user:read",
-            "file_content:read",
-            "file_metadata:read",
-            "projects:read"
-          ]
-        }
-      },
-      "http": {
-        "apiBaseUrl": "https://api.figma.com",
-        "defaultTool": {
-          "name": "get_file",
-          "description": "Fetch a Figma file by key.",
-          "method": "GET",
-          "path": "/v1/files/{fileKey}"
-        }
-      }
-    },
     {
       "id": "api",
       "provider": "mcp",
@@ -63,6 +36,27 @@
       "auth": {
         "strategy": "api_key"
       }
+    },
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://www.figma.com/oauth",
+          "tokenUrl": "https://api.figma.com/v1/oauth/token",
+          "scopes": [
+            "current_user:read",
+            "file_content:read",
+            "file_metadata:read",
+            "projects:read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.figma.com",
+        "openApiUrl": "https://raw.githubusercontent.com/figma/rest-api-spec/main/openapi/openapi.yaml"
+      }
     }
   ],
   "iconBg": "var(--oh-surface)",

package/integrations/catalog/github.json

@@ -28,15 +28,6 @@
       "transport": {
         "kind": "shttp",
         "url": "https://api.githubcopilot.com/mcp/"
-      },
-      "http": {
-        "apiBaseUrl": "https://api.github.com",
-        "defaultTool": {
-          "name": "get_authenticated_user",
-          "description": "Fetch the authenticated GitHub user profile.",
-          "method": "GET",
-          "path": "/user"
-        }
       }
     },
     {

package/integrations/catalog/gmail.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://gmail.googleapis.com",
-        "defaultTool": {
-          "name": "list_messages",
-          "description": "List Gmail messages for the authenticated user.",
-          "method": "GET",
-          "path": "/gmail/v1/users/me/messages"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/googleapis.com/gmail/v1/openapi.json"
       }
     }
   ]

package/integrations/catalog/google-calendar.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://www.googleapis.com/calendar/v3",
-        "defaultTool": {
-          "name": "list_events",
-          "description": "List events from the user's primary Google Calendar.",
-          "method": "GET",
-          "path": "/calendars/primary/events"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/googleapis.com/calendar/v3/openapi.json"
       }
     }
   ]

package/integrations/catalog/google-docs.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://docs.googleapis.com",
-        "defaultTool": {
-          "name": "get_document",
-          "description": "Fetch a Google Docs document by ID.",
-          "method": "GET",
-          "path": "/v1/documents/{documentId}"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/googleapis.com/docs/v1/openapi.json"
       }
     }
   ]

package/integrations/catalog/google-drive.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://www.googleapis.com/drive/v3",
-        "defaultTool": {
-          "name": "list_files",
-          "description": "List Drive files visible to the connected user.",
-          "method": "GET",
-          "path": "/files"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/googleapis.com/drive/v3/openapi.json"
       }
     }
   ]

package/integrations/catalog/google-sheets.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://sheets.googleapis.com",
-        "defaultTool": {
-          "name": "get_spreadsheet",
-          "description": "Fetch spreadsheet metadata and sheets by ID.",
-          "method": "GET",
-          "path": "/v4/spreadsheets/{spreadsheetId}"
-        }
+        "openApiUrl": "https://api.apis.guru/v2/specs/googleapis.com/sheets/v4/openapi.json"
       }
     }
   ]

package/integrations/catalog/intercom.json

@@ -27,12 +27,7 @@
       },
       "http": {
         "apiBaseUrl": "https://api.intercom.io",
-        "defaultTool": {
-          "name": "list_contacts",
-          "description": "List Intercom contacts for the connected workspace.",
-          "method": "GET",
-          "path": "/contacts"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/intercom/Intercom-OpenAPI/main/descriptions/2.15/api.intercom.io.yaml"
       }
     }
   ]

package/integrations/catalog/jira.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://api.atlassian.com/ex/jira/{cloudId}",
-        "defaultTool": {
-          "name": "list_projects",
-          "description": "List Jira projects available to the connected user.",
-          "method": "GET",
-          "path": "/rest/api/3/project/search"
-        }
+        "openApiUrl": "https://developer.atlassian.com/cloud/jira/platform/swagger.v3.json"
       }
     }
   ]

package/integrations/catalog/linear.json

@@ -11,29 +11,6 @@
   "notes": "Popular among modern product engineering teams and already useful to this repo's users.",
   "popularityRank": 86,
   "connectionOptions": [
-    {
-      "id": "oauth",
-      "provider": "http",
-      "auth": {
-        "strategy": "oauth2",
-        "oauth": {
-          "authorizationUrl": "https://linear.app/oauth/authorize",
-          "tokenUrl": "https://api.linear.app/oauth/token",
-          "scopes": [
-            "read"
-          ]
-        }
-      },
-      "http": {
-        "apiBaseUrl": "https://api.linear.app",
-        "defaultTool": {
-          "name": "list_issues",
-          "description": "Query issues from Linear via GraphQL.",
-          "method": "POST",
-          "path": "/graphql"
-        }
-      }
-    },
     {
       "id": "api-key",
       "provider": "mcp",
@@ -59,5 +36,5 @@
     "tasks",
     "tickets"
   ],
-  "installHint": "Authenticate with a Linear API key (Linear \u2192 Settings \u2192 Security & access) \u2014 sent as a Bearer token. Optional when the endpoint accepts your OAuth session."
+  "installHint": "Authenticate with a Linear API key (Linear → Settings → Security & access) — sent as a Bearer token. Optional when the endpoint accepts your OAuth session."
 }

package/integrations/catalog/microsoft-outlook.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://graph.microsoft.com/v1.0",
-        "defaultTool": {
-          "name": "list_messages",
-          "description": "List Outlook messages for the signed-in user.",
-          "method": "GET",
-          "path": "/me/messages"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml"
       }
     }
   ]

package/integrations/catalog/microsoft-teams.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://graph.microsoft.com/v1.0",
-        "defaultTool": {
-          "name": "list_teams",
-          "description": "List Microsoft Teams joined by the signed-in user.",
-          "method": "GET",
-          "path": "/me/joinedTeams"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml"
       }
     }
   ]

package/integrations/catalog/miro.json

@@ -7,13 +7,22 @@
     "Collaboration"
   ],
   "appUrl": "https://miro.com",
-  "docsUrl": "https://developers.miro.com/docs/rest-api-build-your-first-oauth-app",
+  "docsUrl": "https://developers.miro.com/docs/mcp-intro",
   "notes": "Strong visual collaboration target for design and product teams.",
   "popularityRank": 33,
+  "iconBg": "#FFD02F",
+  "logoUrl": "https://cdn.simpleicons.org/miro/05003B",
+  "keywords": [
+    "whiteboard",
+    "collaboration",
+    "diagrams",
+    "visual"
+  ],
+  "installHint": "Connect Miro's hosted MCP server with OAuth.",
   "connectionOptions": [
     {
       "id": "oauth",
-      "provider": "http",
+      "provider": "mcp",
       "auth": {
         "strategy": "oauth2",
         "oauth": {
@@ -24,14 +33,9 @@
           ]
         }
       },
-      "http": {
-        "apiBaseUrl": "https://api.miro.com/v2",
-        "defaultTool": {
-          "name": "list_boards",
-          "description": "List Miro boards available to the connected user.",
-          "method": "GET",
-          "path": "/boards"
-        }
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.miro.com/"
       }
     }
   ]

package/integrations/catalog/monday.json

@@ -7,13 +7,22 @@
     "Operations"
   ],
   "appUrl": "https://monday.com",
-  "docsUrl": "https://developer.monday.com/apps/docs/oauth",
+  "docsUrl": "https://monday.com/w/mcp",
   "notes": "High-demand operations platform with rich board APIs.",
   "popularityRank": 16,
+  "iconBg": "#FF3D00",
+  "logoUrl": "https://cdn.simpleicons.org/mondaydotcom/FFFFFF",
+  "keywords": [
+    "project management",
+    "boards",
+    "work",
+    "operations"
+  ],
+  "installHint": "Connect monday.com's hosted MCP server with OAuth.",
   "connectionOptions": [
     {
       "id": "oauth",
-      "provider": "http",
+      "provider": "mcp",
       "auth": {
         "strategy": "oauth2",
         "oauth": {
@@ -24,14 +33,9 @@
           ]
         }
       },
-      "http": {
-        "apiBaseUrl": "https://api.monday.com/v2",
-        "defaultTool": {
-          "name": "list_boards",
-          "description": "Query boards from Monday.com.",
-          "method": "POST",
-          "path": "/"
-        }
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.monday.com/mcp"
       }
     }
   ]

package/integrations/catalog/netlify.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://api.netlify.com/api/v1",
-        "defaultTool": {
-          "name": "list_sites",
-          "description": "List Netlify sites available to the connected user.",
-          "method": "GET",
-          "path": "/sites"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/netlify/open-api/master/swagger.yml"
       }
     }
   ]

package/integrations/catalog/notion.json

@@ -8,31 +8,8 @@
   ],
   "appUrl": "https://www.notion.so",
   "docsUrl": "https://developers.notion.com/docs/mcp",
-  "notes": "",
   "popularityRank": 82,
   "connectionOptions": [
-    {
-      "id": "oauth",
-      "provider": "http",
-      "auth": {
-        "strategy": "oauth2",
-        "oauth": {
-          "authorizationUrl": "https://api.notion.com/v1/oauth/authorize",
-          "tokenUrl": "https://api.notion.com/v1/oauth/token",
-          "scopes": []
-        }
-      },
-      "http": {
-        "apiBaseUrl": "https://api.notion.com",
-        "openApiUrl": "https://developers.notion.com/openapi.json",
-        "defaultTool": {
-          "name": "post_search",
-          "description": "Search pages and databases in the connected Notion workspace.",
-          "method": "POST",
-          "path": "/v1/search"
-        }
-      }
-    },
     {
       "id": "api",
       "provider": "mcp",
@@ -59,6 +36,22 @@
       "auth": {
         "strategy": "api_key"
       }
+    },
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://api.notion.com/v1/oauth/authorize",
+          "tokenUrl": "https://api.notion.com/v1/oauth/token",
+          "scopes": []
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.notion.com",
+        "openApiUrl": "https://developers.notion.com/openapi.json"
+      }
     }
   ],
   "iconBg": "#FFFFFF",

package/integrations/catalog/okta.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://{yourOktaDomain}/api/v1",
-        "defaultTool": {
-          "name": "list_users",
-          "description": "List Okta users for the connected org.",
-          "method": "GET",
-          "path": "/users"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/okta/okta-sdk-java/master/src/swagger/api.yaml"
       }
     }
   ]

package/integrations/catalog/onedrive.json

@@ -26,12 +26,7 @@
       },
       "http": {
         "apiBaseUrl": "https://graph.microsoft.com/v1.0",
-        "defaultTool": {
-          "name": "list_drive_items",
-          "description": "List OneDrive items in the root folder.",
-          "method": "GET",
-          "path": "/me/drive/root/children"
-        }
+        "openApiUrl": "https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/master/openapi/v1.0/openapi.yaml"
       }
     }
   ]