integrate-sdk 0.9.27-dev.1 → 0.9.28-dev.0

package/README.md

@@ -132,6 +132,88 @@ const result = await client.github.createIssue({
 console.log("Issue created:", result);
 ```
 
+### API Key Integrations
+
+Use API-key integrations like Granola by passing the credential directly to the integration helper:
+
+```typescript
+import { createMCPClient, granolaIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    granolaIntegration({
+      apiKey: process.env.GRANOLA_API_KEY!,
+    }),
+  ],
+});
+
+const notes = await client.callTool("granola_list_notes", {
+  page_size: 10,
+});
+
+const note = await client.callTool("granola_get_note", {
+  note_id: "not_123",
+  include_transcript: true,
+});
+
+const folders = await client.callTool("granola_list_folders", {
+  page_size: 10,
+});
+```
+
+Mercury uses the same API-token pattern:
+
+```typescript
+import { createMCPClient, mercuryIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    mercuryIntegration({
+      apiKey: process.env.MERCURY_API_KEY!,
+    }),
+  ],
+});
+
+const org = await client.callTool("mercury_get_organization");
+const accounts = await client.callTool("mercury_list_accounts", {
+  limit: 50,
+});
+const txns = await client.callTool("mercury_list_transactions", {
+  start: "2026-01-01",
+  end: "2026-01-31",
+  limit: 100,
+});
+```
+
+### OAuth File Storage Integrations
+
+Dropbox follows the standard OAuth integration flow:
+
+```typescript
+import { createMCPClient, dropboxIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    dropboxIntegration({
+      scopes: [
+        "account_info.read",
+        "files.metadata.read",
+        "files.content.read",
+        "files.content.write",
+        "sharing.read",
+        "sharing.write",
+      ],
+    }),
+  ],
+});
+
+const account = await client.callTool("dropbox_get_current_account");
+const files = await client.callTool("dropbox_list_folder", {
+  path: "/",
+  limit: 50,
+});
+```
+
 **That's it!** The SDK automatically:
 
 - ✅ Connects on first method call (no manual `connect()` needed)

package/dist/adapters/auto-routes.js

@@ -284,6 +284,180 @@ function getContextCookieFromRequest(request) {
 }
 var CONTEXT_COOKIE_NAME = "__integrate_oauth_ctx", CONTEXT_COOKIE_MAX_AGE = 300;
 
+// ../integrations/library-metadata.ts
+function integrationLibraryPresentationFields(integration) {
+  const id = typeof integration["id"] === "string" ? integration["id"] : String(integration["id"] ?? "");
+  const fromCatalog = id ? INTEGRATION_LIBRARY_METADATA[id] : undefined;
+  const explicitDescription = integration["description"];
+  const explicitCategory = integration["category"];
+  const description = typeof explicitDescription === "string" && explicitDescription.trim().length > 0 ? explicitDescription.trim() : fromCatalog?.description;
+  const category = typeof explicitCategory === "string" && explicitCategory.trim().length > 0 ? explicitCategory.trim() : fromCatalog?.category;
+  const out = {};
+  if (description)
+    out.description = description;
+  if (category)
+    out.category = category;
+  return out;
+}
+var INTEGRATION_LIBRARY_METADATA;
+var init_library_metadata = __esm(() => {
+  INTEGRATION_LIBRARY_METADATA = {
+    airtable: {
+      description: "Manage Airtable bases, tables, and records",
+      category: "Business"
+    },
+    calcom: {
+      description: "Manage Cal.com bookings and schedules",
+      category: "Productivity"
+    },
+    cursor: {
+      description: "Manage Cursor Cloud Agents and background tasks",
+      category: "Engineering"
+    },
+    figma: {
+      description: "Access Figma files, comments, and components",
+      category: "Engineering"
+    },
+    github: {
+      description: "Manage GitHub repos, issues, and pull requests",
+      category: "Engineering"
+    },
+    gmail: {
+      description: "Send, read, and search Gmail messages",
+      category: "Communication"
+    },
+    gcal: {
+      description: "Manage Google Calendar events and schedules",
+      category: "Productivity"
+    },
+    hubspot: {
+      description: "Manage HubSpot contacts, deals, and tickets",
+      category: "Business"
+    },
+    intercom: {
+      description: "Manage Intercom contacts and conversations",
+      category: "Business"
+    },
+    linear: {
+      description: "Manage Linear issues, projects, and cycles",
+      category: "Engineering"
+    },
+    notion: {
+      description: "Manage Notion pages and databases",
+      category: "Productivity"
+    },
+    onedrive: {
+      description: "Manage OneDrive files, folders, and sharing",
+      category: "Storage"
+    },
+    outlook: {
+      description: "Manage Outlook mail, calendars, and contacts",
+      category: "Communication"
+    },
+    polar: {
+      description: "Manage Polar products, orders, and subscriptions",
+      category: "Business"
+    },
+    ramp: {
+      description: "Manage Ramp corporate cards, bills, and spend",
+      category: "Business"
+    },
+    slack: {
+      description: "Send and manage Slack messages and channels",
+      category: "Communication"
+    },
+    stripe: {
+      description: "Manage Stripe customers, payments, and subscriptions",
+      category: "Business"
+    },
+    todoist: {
+      description: "Manage Todoist tasks, projects, and labels",
+      category: "Productivity"
+    },
+    gslides: {
+      description: "Create and update Google Slides presentations",
+      category: "Productivity"
+    },
+    gsheets: {
+      description: "Read and update Google Sheets spreadsheets",
+      category: "Productivity"
+    },
+    gdocs: {
+      description: "Create and edit Google Docs documents",
+      category: "Productivity"
+    },
+    gdrive: {
+      description: "Manage Google Drive files, folders, and sharing",
+      category: "Storage"
+    },
+    vercel: {
+      description: "Manage Vercel projects, deployments, and domains",
+      category: "Engineering"
+    },
+    whatsapp: {
+      description: "Send WhatsApp messages and templates",
+      category: "Communication"
+    },
+    youtube: {
+      description: "Search and access YouTube videos and channels",
+      category: "Communication"
+    },
+    powerpoint: {
+      description: "Manage PowerPoint presentations and sharing",
+      category: "Productivity"
+    },
+    excel: {
+      description: "Manage Excel workbooks, worksheets, and tables",
+      category: "Productivity"
+    },
+    word: {
+      description: "Manage Word documents and sharing",
+      category: "Productivity"
+    },
+    dropbox: {
+      description: "Manage Dropbox files, folders, and sharing",
+      category: "Storage"
+    },
+    granola: {
+      description: "List and read Granola meeting notes and folders",
+      category: "Productivity"
+    },
+    mercury: {
+      description: "Manage Mercury bank accounts, cards, and transactions",
+      category: "Business"
+    },
+    zendesk: {
+      description: "Manage Zendesk tickets, users, and help center content",
+      category: "Business"
+    }
+  };
+});
+
+// ../integrations/integration-summary.ts
+function toConfiguredIntegrationSummary(integration) {
+  const row = integration;
+  const pres = integrationLibraryPresentationFields(row);
+  return {
+    id: integration.id,
+    name: row.name || integration.id,
+    logoUrl: row.logoUrl,
+    tools: integration.tools,
+    hasOAuth: !!integration.oauth,
+    scopes: integration.oauth?.scopes,
+    provider: integration.oauth?.provider,
+    ...pres
+  };
+}
+function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
+  return {
+    ...toConfiguredIntegrationSummary(integration),
+    toolMetadata
+  };
+}
+var init_integration_summary = __esm(() => {
+  init_library_metadata();
+});
+
 // ../utils/logger.ts
 function shouldLog(level, context) {
   return logLevelHierarchy[level] <= logLevelHierarchy[contextLogLevels[context]];
@@ -447,14 +621,8 @@ class OAuthHandler {
     const integrations = this.config.integrations || [];
     return {
       integrations: integrations.map((integration) => ({
-        id: integration.id,
-        name: integration.name || integration.id,
-        logoUrl: integration.logoUrl,
-        tools: integration.tools,
-        hasOAuth: !!integration.oauth,
-        scopes: integration.oauth?.scopes,
-        optionalScopes: integration.oauth?.optionalScopes,
-        provider: integration.oauth?.provider
+        ...toConfiguredIntegrationSummary(integration),
+        optionalScopes: integration.oauth?.optionalScopes
       }))
     };
   }
@@ -841,6 +1009,7 @@ class OAuthHandler {
 }
 var SERVER_LOG_CONTEXT = "server", logger2, MCP_SERVER_URL = "https://mcp.integrate.dev/api/v1/mcp";
 var init_base_handler = __esm(() => {
+  init_integration_summary();
   init_email_fetcher();
   init_logger();
   logger2 = createLogger("OAuthHandler", SERVER_LOG_CONTEXT);

package/dist/adapters/base-handler.d.ts

@@ -240,10 +240,12 @@ export declare class OAuthHandler {
             id: string;
             name: string;
             logoUrl?: string;
+            description?: string;
+            category?: string;
             tools: readonly string[];
             hasOAuth: boolean;
-            scopes?: string[];
-            optionalScopes?: string[];
+            scopes?: readonly string[];
+            optionalScopes?: readonly string[];
             provider?: string;
         }>;
     };

package/dist/adapters/base-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/adapters/base-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/adapters/base-handler.ts"],"names":[],"mappings":"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"}

package/dist/adapters/base-handler.js

@@ -284,6 +284,180 @@ function getContextCookieFromRequest(request) {
 }
 var CONTEXT_COOKIE_NAME = "__integrate_oauth_ctx", CONTEXT_COOKIE_MAX_AGE = 300;
 
+// ../integrations/library-metadata.ts
+function integrationLibraryPresentationFields(integration) {
+  const id = typeof integration["id"] === "string" ? integration["id"] : String(integration["id"] ?? "");
+  const fromCatalog = id ? INTEGRATION_LIBRARY_METADATA[id] : undefined;
+  const explicitDescription = integration["description"];
+  const explicitCategory = integration["category"];
+  const description = typeof explicitDescription === "string" && explicitDescription.trim().length > 0 ? explicitDescription.trim() : fromCatalog?.description;
+  const category = typeof explicitCategory === "string" && explicitCategory.trim().length > 0 ? explicitCategory.trim() : fromCatalog?.category;
+  const out = {};
+  if (description)
+    out.description = description;
+  if (category)
+    out.category = category;
+  return out;
+}
+var INTEGRATION_LIBRARY_METADATA;
+var init_library_metadata = __esm(() => {
+  INTEGRATION_LIBRARY_METADATA = {
+    airtable: {
+      description: "Manage Airtable bases, tables, and records",
+      category: "Business"
+    },
+    calcom: {
+      description: "Manage Cal.com bookings and schedules",
+      category: "Productivity"
+    },
+    cursor: {
+      description: "Manage Cursor Cloud Agents and background tasks",
+      category: "Engineering"
+    },
+    figma: {
+      description: "Access Figma files, comments, and components",
+      category: "Engineering"
+    },
+    github: {
+      description: "Manage GitHub repos, issues, and pull requests",
+      category: "Engineering"
+    },
+    gmail: {
+      description: "Send, read, and search Gmail messages",
+      category: "Communication"
+    },
+    gcal: {
+      description: "Manage Google Calendar events and schedules",
+      category: "Productivity"
+    },
+    hubspot: {
+      description: "Manage HubSpot contacts, deals, and tickets",
+      category: "Business"
+    },
+    intercom: {
+      description: "Manage Intercom contacts and conversations",
+      category: "Business"
+    },
+    linear: {
+      description: "Manage Linear issues, projects, and cycles",
+      category: "Engineering"
+    },
+    notion: {
+      description: "Manage Notion pages and databases",
+      category: "Productivity"
+    },
+    onedrive: {
+      description: "Manage OneDrive files, folders, and sharing",
+      category: "Storage"
+    },
+    outlook: {
+      description: "Manage Outlook mail, calendars, and contacts",
+      category: "Communication"
+    },
+    polar: {
+      description: "Manage Polar products, orders, and subscriptions",
+      category: "Business"
+    },
+    ramp: {
+      description: "Manage Ramp corporate cards, bills, and spend",
+      category: "Business"
+    },
+    slack: {
+      description: "Send and manage Slack messages and channels",
+      category: "Communication"
+    },
+    stripe: {
+      description: "Manage Stripe customers, payments, and subscriptions",
+      category: "Business"
+    },
+    todoist: {
+      description: "Manage Todoist tasks, projects, and labels",
+      category: "Productivity"
+    },
+    gslides: {
+      description: "Create and update Google Slides presentations",
+      category: "Productivity"
+    },
+    gsheets: {
+      description: "Read and update Google Sheets spreadsheets",
+      category: "Productivity"
+    },
+    gdocs: {
+      description: "Create and edit Google Docs documents",
+      category: "Productivity"
+    },
+    gdrive: {
+      description: "Manage Google Drive files, folders, and sharing",
+      category: "Storage"
+    },
+    vercel: {
+      description: "Manage Vercel projects, deployments, and domains",
+      category: "Engineering"
+    },
+    whatsapp: {
+      description: "Send WhatsApp messages and templates",
+      category: "Communication"
+    },
+    youtube: {
+      description: "Search and access YouTube videos and channels",
+      category: "Communication"
+    },
+    powerpoint: {
+      description: "Manage PowerPoint presentations and sharing",
+      category: "Productivity"
+    },
+    excel: {
+      description: "Manage Excel workbooks, worksheets, and tables",
+      category: "Productivity"
+    },
+    word: {
+      description: "Manage Word documents and sharing",
+      category: "Productivity"
+    },
+    dropbox: {
+      description: "Manage Dropbox files, folders, and sharing",
+      category: "Storage"
+    },
+    granola: {
+      description: "List and read Granola meeting notes and folders",
+      category: "Productivity"
+    },
+    mercury: {
+      description: "Manage Mercury bank accounts, cards, and transactions",
+      category: "Business"
+    },
+    zendesk: {
+      description: "Manage Zendesk tickets, users, and help center content",
+      category: "Business"
+    }
+  };
+});
+
+// ../integrations/integration-summary.ts
+function toConfiguredIntegrationSummary(integration) {
+  const row = integration;
+  const pres = integrationLibraryPresentationFields(row);
+  return {
+    id: integration.id,
+    name: row.name || integration.id,
+    logoUrl: row.logoUrl,
+    tools: integration.tools,
+    hasOAuth: !!integration.oauth,
+    scopes: integration.oauth?.scopes,
+    provider: integration.oauth?.provider,
+    ...pres
+  };
+}
+function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
+  return {
+    ...toConfiguredIntegrationSummary(integration),
+    toolMetadata
+  };
+}
+var init_integration_summary = __esm(() => {
+  init_library_metadata();
+});
+
 // ../utils/logger.ts
 function shouldLog(level, context) {
   return logLevelHierarchy[level] <= logLevelHierarchy[contextLogLevels[context]];
@@ -447,14 +621,8 @@ class OAuthHandler {
     const integrations = this.config.integrations || [];
     return {
       integrations: integrations.map((integration) => ({
-        id: integration.id,
-        name: integration.name || integration.id,
-        logoUrl: integration.logoUrl,
-        tools: integration.tools,
-        hasOAuth: !!integration.oauth,
-        scopes: integration.oauth?.scopes,
-        optionalScopes: integration.oauth?.optionalScopes,
-        provider: integration.oauth?.provider
+        ...toConfiguredIntegrationSummary(integration),
+        optionalScopes: integration.oauth?.optionalScopes
       }))
     };
   }
@@ -841,6 +1009,7 @@ class OAuthHandler {
 }
 var SERVER_LOG_CONTEXT = "server", logger2, MCP_SERVER_URL = "https://mcp.integrate.dev/api/v1/mcp";
 var init_base_handler = __esm(() => {
+  init_integration_summary();
   init_email_fetcher();
   init_logger();
   logger2 = createLogger("OAuthHandler", SERVER_LOG_CONTEXT);