@openhands/extensions 0.0.1-alpha

package/integrations/oauth-provider-catalog.js

@@ -0,0 +1,553 @@
+import { getOAuthProviderRegistrationDefaults } from "./oauth-provider-registration-defaults.js";
+const provider = (popularityRank, option) => {
+  const registrationDefaults = getOAuthProviderRegistrationDefaults(option.slug);
+
+  return {
+    ...option,
+    authStrategy: option.authStrategy ?? registrationDefaults?.authStrategy ?? "oauth2",
+    popularityRank,
+    registrationDefaults,
+  };
+};
+
+const oauthProviderCatalog = [
+  provider(1, {
+    slug: "github",
+    name: "GitHub",
+    description: "Source control, issues, pull requests, and developer workflows.",
+    categories: ["Engineering", "Source control"],
+    availability: "manual_token",
+    managedConnectorSlug: "github",
+    appUrl: "https://github.com",
+    docsUrl: "https://docs.github.com/apps/oauth-apps/building-oauth-apps",
+    notes: "Current managed connector works with bearer tokens today; GitHub OAuth is a strong candidate for a future one-click connect flow.",
+  }),
+  provider(2, {
+    slug: "google-docs",
+    name: "Google Docs",
+    description: "Docs authoring and Google Workspace document automation.",
+    categories: ["Documents", "Knowledge base"],
+    availability: "manual_token",
+    managedConnectorSlug: "google-docs",
+    appUrl: "https://workspace.google.com/products/docs/",
+    docsUrl: "https://developers.google.com/identity/protocols/oauth2",
+    notes: "Current managed connector accepts a Google access token manually; a full OAuth connect flow can remove token copy/paste.",
+  }),
+  provider(3, {
+    slug: "slack",
+    name: "Slack",
+    description: "Channels, messaging, workflows, canvases, and operational collaboration.",
+    categories: ["Communication", "Operations"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "slack",
+    appUrl: "https://slack.com",
+    docsUrl: "https://docs.slack.dev/ai/slack-mcp-server",
+    notes: "Uses Slack's official hosted MCP server with confidential OAuth user-token auth.",
+  }),
+  provider(4, {
+    slug: "notion",
+    name: "Notion",
+    description: "Workspace search, pages, databases, and knowledge management.",
+    categories: ["Knowledge base", "Documentation"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "notion",
+    appUrl: "https://www.notion.so",
+    docsUrl: "https://developers.notion.com/docs/authorization",
+    notes: "",
+  }),
+  provider(5, {
+    slug: "figma",
+    name: "Figma",
+    description: "Design files, nodes, and developer handoff automation.",
+    categories: ["Design", "Frontend"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "figma",
+    appUrl: "https://www.figma.com",
+    docsUrl: "https://www.figma.com/developers/api#oauth2",
+    notes: "",
+  }),
+  provider(6, {
+    slug: "google-drive",
+    name: "Google Drive",
+    description: "File search, metadata, folders, and document discovery.",
+    categories: ["Storage", "Documents"],
+    availability: "planned",
+    appUrl: "https://workspace.google.com/products/drive/",
+    docsUrl: "https://developers.google.com/identity/protocols/oauth2",
+    notes: "Natural expansion of the Google Workspace surface beyond Google Docs.",
+  }),
+  provider(7, {
+    slug: "google-sheets",
+    name: "Google Sheets",
+    description: "Spreadsheet reads, writes, formulas, and reporting workflows.",
+    categories: ["Spreadsheets", "Analytics"],
+    availability: "planned",
+    appUrl: "https://workspace.google.com/products/sheets/",
+    docsUrl: "https://developers.google.com/identity/protocols/oauth2",
+    notes: "High-value automation surface for agent-driven reporting and structured edits.",
+  }),
+  provider(8, {
+    slug: "gmail",
+    name: "Gmail",
+    description: "Mailbox search, drafting, sending, and thread triage.",
+    categories: ["Communication", "Email"],
+    availability: "planned",
+    appUrl: "https://workspace.google.com/products/gmail/",
+    docsUrl: "https://developers.google.com/identity/protocols/oauth2",
+    notes: "Popular agent workflow target for inbox triage and drafting.",
+  }),
+  provider(9, {
+    slug: "google-calendar",
+    name: "Google Calendar",
+    description: "Calendar search, event scheduling, and meeting coordination.",
+    categories: ["Calendar", "Scheduling"],
+    availability: "planned",
+    appUrl: "https://workspace.google.com/products/calendar/",
+    docsUrl: "https://developers.google.com/identity/protocols/oauth2",
+    notes: "Strong personal productivity use case with mature OAuth flows.",
+  }),
+  provider(10, {
+    slug: "jira",
+    name: "Jira",
+    description: "Issue tracking, sprint workflows, and engineering program management.",
+    categories: ["Project management", "Engineering"],
+    availability: "planned",
+    appUrl: "https://www.atlassian.com/software/jira",
+    docsUrl: "https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/",
+    notes: "Very common MCP target for software teams and ticket automation.",
+  }),
+  provider(11, {
+    slug: "confluence",
+    name: "Confluence",
+    description: "Wiki pages, spaces, and internal documentation search.",
+    categories: ["Documentation", "Knowledge base"],
+    availability: "planned",
+    appUrl: "https://www.atlassian.com/software/confluence",
+    docsUrl: "https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/",
+    notes: "Natural companion to Jira for software teams.",
+  }),
+  provider(12, {
+    slug: "linear",
+    name: "Linear",
+    description: "Issue tracking, roadmap planning, and product engineering workflows.",
+    categories: ["Project management", "Engineering"],
+    availability: "planned",
+    appUrl: "https://linear.app",
+    docsUrl: "https://linear.app/developers/oauth-authentication",
+    notes: "Popular among modern product engineering teams and already useful to this repo's users.",
+  }),
+  provider(13, {
+    slug: "asana",
+    name: "Asana",
+    description: "Task management, projects, and work tracking.",
+    categories: ["Project management", "Operations"],
+    availability: "planned",
+    appUrl: "https://asana.com",
+    docsUrl: "https://developers.asana.com/docs/oauth",
+    notes: "Broad business adoption and straightforward OAuth app model.",
+  }),
+  provider(14, {
+    slug: "trello",
+    name: "Trello",
+    description: "Boards, cards, checklists, and lightweight project planning.",
+    categories: ["Project management", "Operations"],
+    availability: "planned",
+    appUrl: "https://trello.com",
+    docsUrl: "https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/",
+    notes: "Useful for SMB and cross-functional task boards, but Trello's public API auth is a special-case flow rather than a straightforward generic OAuth2 connector.",
+  }),
+  provider(15, {
+    slug: "clickup",
+    name: "ClickUp",
+    description: "Tasks, docs, goals, and workflow automation.",
+    categories: ["Project management", "Operations"],
+    availability: "planned",
+    appUrl: "https://clickup.com",
+    docsUrl: "https://clickup.com/api/developer-portal/authentication",
+    notes: "Large install base and broad operations coverage.",
+  }),
+  provider(16, {
+    slug: "monday",
+    name: "Monday.com",
+    description: "Boards, automations, and work management across teams.",
+    categories: ["Project management", "Operations"],
+    availability: "planned",
+    appUrl: "https://monday.com",
+    docsUrl: "https://developer.monday.com/apps/docs/oauth",
+    notes: "High-demand operations platform with rich board APIs.",
+  }),
+  provider(17, {
+    slug: "airtable",
+    name: "Airtable",
+    description: "Bases, records, linked data, and workflow automation.",
+    categories: ["Database", "Operations"],
+    availability: "planned",
+    appUrl: "https://airtable.com",
+    docsUrl: "https://airtable.com/developers/web/api/oauth-reference",
+    notes: "Very common internal-tools and operations automation surface.",
+  }),
+  provider(18, {
+    slug: "dropbox",
+    name: "Dropbox",
+    description: "Cloud files, folders, content access, and sharing.",
+    categories: ["Storage", "Documents"],
+    availability: "planned",
+    appUrl: "https://www.dropbox.com",
+    docsUrl: "https://developers.dropbox.com/oauth-guide",
+    notes: "Popular file automation target with mature OAuth support.",
+  }),
+  provider(19, {
+    slug: "box",
+    name: "Box",
+    description: "Enterprise file storage, metadata, and collaboration.",
+    categories: ["Storage", "Enterprise"],
+    availability: "planned",
+    appUrl: "https://www.box.com",
+    docsUrl: "https://developer.box.com/guides/authentication/oauth2/",
+    notes: "Strong enterprise document-management footprint.",
+  }),
+  provider(20, {
+    slug: "microsoft-outlook",
+    name: "Microsoft Outlook",
+    description: "Mail, calendar, contacts, and meeting workflows through Microsoft Graph.",
+    categories: ["Email", "Calendar"],
+    availability: "planned",
+    appUrl: "https://www.microsoft.com/microsoft-365/outlook/email-and-calendar-software-microsoft-outlook",
+    docsUrl: "https://learn.microsoft.com/graph/auth-v2-user",
+    notes: "High-value Microsoft Graph integration surface for enterprise users.",
+  }),
+  provider(21, {
+    slug: "microsoft-teams",
+    name: "Microsoft Teams",
+    description: "Chats, channels, meetings, and collaboration via Microsoft Graph.",
+    categories: ["Communication", "Enterprise"],
+    availability: "planned",
+    appUrl: "https://www.microsoft.com/microsoft-teams/group-chat-software",
+    docsUrl: "https://learn.microsoft.com/graph/auth-v2-user",
+    notes: "Common enterprise chat target alongside Outlook.",
+  }),
+  provider(22, {
+    slug: "onedrive",
+    name: "OneDrive",
+    description: "Cloud file access and document workflows through Microsoft Graph.",
+    categories: ["Storage", "Documents"],
+    availability: "planned",
+    appUrl: "https://www.microsoft.com/microsoft-365/onedrive/online-cloud-storage",
+    docsUrl: "https://learn.microsoft.com/graph/auth-v2-user",
+    notes: "Useful for enterprise file automation and search.",
+  }),
+  provider(23, {
+    slug: "sharepoint",
+    name: "SharePoint",
+    description: "Sites, document libraries, lists, and intranet content.",
+    categories: ["Knowledge base", "Enterprise"],
+    availability: "planned",
+    appUrl: "https://www.microsoft.com/microsoft-365/sharepoint/collaboration",
+    docsUrl: "https://learn.microsoft.com/graph/auth-v2-user",
+    notes: "Frequently requested for enterprise knowledge retrieval.",
+  }),
+  provider(24, {
+    slug: "salesforce",
+    name: "Salesforce",
+    description: "CRM records, accounts, opportunities, and sales operations.",
+    categories: ["CRM", "Sales"],
+    availability: "planned",
+    appUrl: "https://www.salesforce.com",
+    docsUrl: "https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_web_server_flow.htm&type=5",
+    notes: "Very common enterprise CRM and agent-assist target.",
+  }),
+  provider(25, {
+    slug: "hubspot",
+    name: "HubSpot",
+    description: "CRM, marketing, tickets, and customer lifecycle workflows.",
+    categories: ["CRM", "Marketing"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "hubspot",
+    appUrl: "https://www.hubspot.com",
+    docsUrl:
+      "https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server",
+    notes: "Uses HubSpot's official remote MCP server plus MCP auth apps with PKCE.",
+  }),
+  provider(26, {
+    slug: "zendesk",
+    name: "Zendesk",
+    description: "Support tickets, customers, agents, and help desk operations.",
+    categories: ["Support", "Operations"],
+    availability: "planned",
+    appUrl: "https://www.zendesk.com",
+    docsUrl: "https://developer.zendesk.com/documentation/apps/getting-started/oauth/",
+    notes: "Strong support automation use case for agents.",
+  }),
+  provider(27, {
+    slug: "intercom",
+    name: "Intercom",
+    description: "Customer support, conversations, inboxes, and CRM context.",
+    categories: ["Support", "CRM"],
+    availability: "planned",
+    appUrl: "https://www.intercom.com",
+    docsUrl: "https://developers.intercom.com/building-apps/docs/authentication-types",
+    notes: "Useful for customer-facing assistant workflows.",
+  }),
+  provider(28, {
+    slug: "stripe",
+    name: "Stripe",
+    description: "Payments, customers, invoices, and subscription operations.",
+    categories: ["Payments", "Finance"],
+    availability: "planned",
+    appUrl: "https://stripe.com",
+    docsUrl: "https://docs.stripe.com/connect/oauth-reference",
+    notes: "High-value fintech automation target with mature OAuth patterns.",
+  }),
+  provider(29, {
+    slug: "shopify",
+    name: "Shopify",
+    description: "Storefronts, products, orders, and ecommerce operations.",
+    categories: ["Ecommerce", "Operations"],
+    availability: "planned",
+    appUrl: "https://www.shopify.com",
+    docsUrl: "https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/authorization-code-grant",
+    notes: "A top ecommerce platform and strong MCP candidate.",
+  }),
+  provider(30, {
+    slug: "discord",
+    name: "Discord",
+    description: "Guilds, channels, messages, and community operations.",
+    categories: ["Communication", "Community"],
+    availability: "planned",
+    appUrl: "https://discord.com",
+    docsUrl: "https://discord.com/developers/docs/topics/oauth2",
+    notes: "Useful for community automation and bot-assisted workflows.",
+  }),
+  provider(31, {
+    slug: "zoom",
+    name: "Zoom",
+    description: "Meetings, recordings, webinars, and scheduling operations.",
+    categories: ["Meetings", "Calendar"],
+    availability: "planned",
+    appUrl: "https://zoom.us",
+    docsUrl: "https://developers.zoom.us/docs/integrations/oauth/",
+    notes: "Frequently requested for scheduling and meeting summaries.",
+  }),
+  provider(32, {
+    slug: "webflow",
+    name: "Webflow",
+    description: "CMS items, sites, and web publishing workflows.",
+    categories: ["CMS", "Marketing"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "webflow",
+    appUrl: "https://webflow.com",
+    docsUrl: "https://developers.webflow.com/mcp/reference/getting-started",
+    notes:
+      "Uses Webflow's official hosted MCP server and deployment-scoped MCP OAuth registration so each user can authorize their own sites and workspaces.",
+  }),
+  provider(33, {
+    slug: "miro",
+    name: "Miro",
+    description: "Whiteboards, diagrams, notes, and workshop collaboration.",
+    categories: ["Whiteboard", "Collaboration"],
+    availability: "planned",
+    appUrl: "https://miro.com",
+    docsUrl: "https://developers.miro.com/docs/rest-api-build-your-first-oauth-app",
+    notes: "Strong visual collaboration target for design and product teams.",
+  }),
+  provider(34, {
+    slug: "canva",
+    name: "Canva",
+    description: "Design content, brand assets, and marketing collateral workflows.",
+    categories: ["Design", "Marketing"],
+    availability: "planned",
+    appUrl: "https://www.canva.com",
+    docsUrl: "https://www.canva.dev/docs/connect/oauth/",
+    notes: "Broad creator and marketing adoption with OAuth-based apps.",
+  }),
+  provider(35, {
+    slug: "datadog",
+    name: "Datadog",
+    description: "Logs, metrics, monitors, incidents, and observability workflows.",
+    categories: ["Observability", "Operations"],
+    availability: "oauth_ready",
+    managedConnectorSlug: "datadog",
+    appUrl: "https://www.datadoghq.com",
+    docsUrl: "https://docs.datadoghq.com/bits_ai/mcp_server/setup/",
+    notes:
+      "Uses Datadog's official hosted MCP server. The default registration targets the US1 endpoint and can be edited for other Datadog sites.",
+  }),
+  provider(36, {
+    slug: "sentry",
+    name: "Sentry",
+    description: "Errors, releases, issue ownership, and incident investigation.",
+    categories: ["Observability", "Engineering"],
+    availability: "planned",
+    appUrl: "https://sentry.io",
+    docsUrl: "https://docs.sentry.io/api/guides/oauth/",
+    notes: "Natural target for engineering support agents.",
+  }),
+  provider(37, {
+    slug: "posthog",
+    name: "PostHog",
+    description: "Product analytics, feature flags, and session insights.",
+    categories: ["Analytics", "Product"],
+    availability: "planned",
+    appUrl: "https://posthog.com",
+    docsUrl: "https://posthog.com/docs/apps/build/oauth",
+    notes: "Relevant for product analytics and experimentation workflows.",
+  }),
+  provider(38, {
+    slug: "supabase",
+    name: "Supabase",
+    description: "Projects, databases, auth, and storage administration.",
+    categories: ["Database", "Developer tools"],
+    availability: "planned",
+    appUrl: "https://supabase.com",
+    docsUrl: "https://supabase.com/docs/guides/integrations/build-a-supabase-oauth-integration",
+    notes: "Popular developer platform with broad automation value and a documented management-API OAuth integration flow.",
+  }),
+  provider(39, {
+    slug: "vercel",
+    name: "Vercel",
+    description: "Deployments, projects, domains, and preview environment workflows.",
+    categories: ["Developer tools", "Deployment"],
+    availability: "planned",
+    appUrl: "https://vercel.com",
+    docsUrl: "https://vercel.com/docs/rest-api#oauth-apps",
+    notes: "Especially relevant to this repo's deployment model.",
+  }),
+  provider(40, {
+    slug: "netlify",
+    name: "Netlify",
+    description: "Sites, builds, deploy previews, and web operations.",
+    categories: ["Deployment", "Developer tools"],
+    availability: "planned",
+    appUrl: "https://www.netlify.com",
+    docsUrl: "https://docs.netlify.com/api/get-started/#oauth-applications",
+    notes: "Common alternative hosting/deployment automation target.",
+  }),
+  provider(41, {
+    slug: "plaid",
+    name: "Plaid",
+    description: "Financial account connectivity and transaction data flows.",
+    categories: ["Finance", "Payments"],
+    availability: "planned",
+    appUrl: "https://plaid.com",
+    docsUrl: "https://plaid.com/docs/auth/oauth/",
+    notes: "Strong fintech workflow candidate, although much of Plaid's OAuth guidance is a special-case token exchange rather than a generic end-user SaaS OAuth connector.",
+  }),
+  provider(42, {
+    slug: "okta",
+    name: "Okta",
+    description: "Identity, users, applications, and access administration.",
+    categories: ["Identity", "Enterprise"],
+    availability: "planned",
+    appUrl: "https://www.okta.com",
+    docsUrl: "https://developer.okta.com/docs/guides/implement-oauth-for-okta/main/",
+    notes: "High-value admin and security automation surface.",
+  }),
+  provider(43, {
+    slug: "servicenow",
+    name: "ServiceNow",
+    description: "Tickets, incidents, service catalogs, and enterprise workflows.",
+    categories: ["ITSM", "Enterprise"],
+    availability: "planned",
+    appUrl: "https://www.servicenow.com",
+    docsUrl: "https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/concept/oauth-concept.html",
+    notes: "Strong enterprise IT operations use case.",
+  }),
+  provider(44, {
+    slug: "freshdesk",
+    name: "Freshdesk",
+    description: "Support tickets, customer records, and help desk workflows.",
+    categories: ["Support", "Operations"],
+    availability: "planned",
+    appUrl: "https://www.freshworks.com/freshdesk/",
+    docsUrl: "https://developers.freshdesk.com/api/#authentication",
+    notes: "Popular support platform for SMB and mid-market teams.",
+  }),
+  provider(45, {
+    slug: "pipedrive",
+    name: "Pipedrive",
+    description: "Deals, contacts, and sales pipeline management.",
+    categories: ["CRM", "Sales"],
+    availability: "planned",
+    appUrl: "https://www.pipedrive.com",
+    docsUrl: "https://pipedrive.readme.io/docs/marketplace-oauth-authorization",
+    notes: "Common CRM choice with solid OAuth story.",
+  }),
+  provider(46, {
+    slug: "mailchimp",
+    name: "Mailchimp",
+    description: "Campaigns, audiences, automations, and email marketing.",
+    categories: ["Marketing", "Email"],
+    availability: "planned",
+    appUrl: "https://mailchimp.com",
+    docsUrl: "https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/",
+    notes: "Popular marketing automation target.",
+  }),
+  provider(47, {
+    slug: "quickbooks",
+    name: "QuickBooks",
+    description: "Accounting, invoices, customers, and financial operations.",
+    categories: ["Finance", "Accounting"],
+    availability: "planned",
+    appUrl: "https://quickbooks.intuit.com",
+    docsUrl: "https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0",
+    notes: "Frequent finance automation request with OAuth-based apps.",
+  }),
+  provider(48, {
+    slug: "xero",
+    name: "Xero",
+    description: "Accounting, contacts, invoices, and bookkeeping workflows.",
+    categories: ["Finance", "Accounting"],
+    availability: "planned",
+    appUrl: "https://www.xero.com",
+    docsUrl: "https://developer.xero.com/documentation/guides/oauth2/overview/",
+    notes: "Important accounting platform in many regions.",
+  }),
+  provider(49, {
+    slug: "gitlab",
+    name: "GitLab",
+    description: "Repositories, issues, merge requests, pipelines, and DevSecOps.",
+    categories: ["Engineering", "Source control"],
+    availability: "planned",
+    appUrl: "https://about.gitlab.com",
+    docsUrl: "https://docs.gitlab.com/integration/oauth_provider/",
+    notes: "Major Git hosting platform and natural expansion beyond GitHub.",
+  }),
+  provider(50, {
+    slug: "bitbucket",
+    name: "Bitbucket",
+    description: "Repositories, pull requests, and Atlassian engineering workflows.",
+    categories: ["Engineering", "Source control"],
+    availability: "planned",
+    appUrl: "https://bitbucket.org",
+    docsUrl: "https://developer.atlassian.com/cloud/bitbucket/oauth-2/",
+    notes: "Popular in Atlassian-centric teams and complements Jira/Confluence.",
+  }),
+  provider(51, {
+    slug: "elevenlabs",
+    name: "ElevenLabs",
+    description: "Text to speech, voices, transcription, audio generation, and agents.",
+    categories: ["Audio", "AI"],
+    authStrategy: "api_key",
+    availability: "manual_token",
+    managedConnectorSlug: "elevenlabs",
+    appUrl: "https://elevenlabs.io",
+    docsUrl: "https://elevenlabs.io/docs/api-reference/introduction",
+    notes:
+      "Official API-key connector backed by ElevenLabs' published OpenAPI spec.",
+  }),
+  provider(52, {
+    slug: "ordinal",
+    name: "Ordinal",
+    description: "Social media posts, profiles, analytics, labels, approvals, and engagements.",
+    categories: ["Social media", "Marketing"],
+    authStrategy: "bearer",
+    availability: "manual_token",
+    managedConnectorSlug: "ordinal",
+    appUrl: "https://app.tryordinal.com",
+    docsUrl: "https://docs.tryordinal.com/api/mcp",
+    notes:
+      "Official MCP server backed by Ordinal's API with API-key (Bearer) auth.",
+  }),
+];
+
+export const listOAuthProviderCatalog = () => oauthProviderCatalog;