@hasna/connectors 0.3.6 → 0.3.7

package/bin/index.js

@@ -6701,7 +6701,7 @@ var PRESETS = {
   commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
 };
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.3.6");
+program2.name("connectors").description("Install API connectors for your project").version("0.3.7");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:

package/bin/mcp.js

@@ -20309,7 +20309,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.3.6"
+  version: "0.3.7"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",

package/connectors/connect-gmail/src/cli/index.ts

@@ -75,7 +75,11 @@ function getFormat(cmd: Command): OutputFormat {
 
 // Helper to check authentication
 function requireAuth(): Gmail {
-  if (!isAuthenticated()) {
+  // isAuthenticated() checks for both accessToken and refreshToken.
+  // If accessToken is missing/expired but refreshToken exists, the client's
+  // getValidAccessToken() will handle the refresh automatically.
+  const tokens = loadTokens();
+  if (!tokens || (!tokens.accessToken && !tokens.refreshToken)) {
     error('Not authenticated. Run "connect-gmail auth login" first.');
     process.exit(1);
   }

package/connectors/connect-google/src/cli/index.ts

@@ -5,6 +5,8 @@ import { Google } from '../api';
 import {
   getAccessToken,
   setAccessToken,
+  getRefreshToken,
+  getValidAccessToken,
   clearConfig,
   getConfigDir,
   setProfileOverride,
@@ -55,12 +57,26 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 // Helper to get authenticated client
-function getClient(): Google {
-  const accessToken = getAccessToken();
+async function getClient(): Promise<Google> {
+  let accessToken = getAccessToken();
+
+  // If no access token, try to refresh using refresh token
   if (!accessToken) {
-    error(`No access token configured. Run "${CONNECTOR_NAME} config set-token <token>" or set GOOGLE_ACCESS_TOKEN environment variable.`);
-    process.exit(1);
+    const refreshToken = getRefreshToken();
+    if (refreshToken) {
+      try {
+        accessToken = await getValidAccessToken();
+      } catch {
+        // Fall through to error below
+      }
+    }
+
+    if (!accessToken) {
+      error(`No access token configured. Run "${CONNECTOR_NAME} config set-token <token>" or set GOOGLE_ACCESS_TOKEN environment variable.`);
+      process.exit(1);
+    }
   }
+
   return new Google({ accessToken });
 }
 
@@ -208,7 +224,7 @@ gmailMessagesCmd
   .option('--labels <labels>', 'Label IDs (comma-separated)')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.listMessages({
         maxResults: parseInt(opts.max),
         q: opts.query,
@@ -227,7 +243,7 @@ gmailMessagesCmd
   .option('--format <format>', 'Message format (minimal, full, raw, metadata)', 'full')
   .action(async (id: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.getMessage(id, { format: opts.format });
       print(result, getFormat(gmailMessagesCmd));
     } catch (err) {
@@ -247,7 +263,7 @@ gmailMessagesCmd
   .option('--html', 'Send as HTML email')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.sendMessage({
         to: opts.to,
         subject: opts.subject,
@@ -269,7 +285,7 @@ gmailMessagesCmd
   .description('Delete a message permanently')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.gmail.deleteMessage(id);
       success(`Message ${id} deleted`);
     } catch (err) {
@@ -283,7 +299,7 @@ gmailMessagesCmd
   .description('Move a message to trash')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.gmail.trashMessage(id);
       success(`Message ${id} moved to trash`);
     } catch (err) {
@@ -297,7 +313,7 @@ gmailMessagesCmd
   .description('Remove a message from trash')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.gmail.untrashMessage(id);
       success(`Message ${id} removed from trash`);
     } catch (err) {
@@ -316,7 +332,7 @@ gmailLabelsCmd
   .description('List all labels')
   .action(async () => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.listLabels();
       print(result, getFormat(gmailLabelsCmd));
     } catch (err) {
@@ -330,7 +346,7 @@ gmailLabelsCmd
   .description('Get a label by ID')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.getLabel(id);
       print(result, getFormat(gmailLabelsCmd));
     } catch (err) {
@@ -344,7 +360,7 @@ gmailLabelsCmd
   .description('Create a new label')
   .action(async (name: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.createLabel(name);
       success('Label created!');
       print(result, getFormat(gmailLabelsCmd));
@@ -359,7 +375,7 @@ gmailLabelsCmd
   .description('Delete a label')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.gmail.deleteLabel(id);
       success(`Label ${id} deleted`);
     } catch (err) {
@@ -379,7 +395,7 @@ gmailDraftsCmd
   .option('-n, --max <number>', 'Maximum results', '10')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.listDrafts({
         maxResults: parseInt(opts.max),
       });
@@ -395,7 +411,7 @@ gmailDraftsCmd
   .description('Get a draft by ID')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.getDraft(id);
       print(result, getFormat(gmailDraftsCmd));
     } catch (err) {
@@ -412,7 +428,7 @@ gmailDraftsCmd
   .requiredOption('--body <body>', 'Email body')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.createDraft({
         to: opts.to,
         subject: opts.subject,
@@ -431,7 +447,7 @@ gmailDraftsCmd
   .description('Delete a draft')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.gmail.deleteDraft(id);
       success(`Draft ${id} deleted`);
     } catch (err) {
@@ -445,7 +461,7 @@ gmailDraftsCmd
   .description('Send a draft')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.gmail.sendDraft(id);
       success('Draft sent!');
       print(result, getFormat(gmailDraftsCmd));
@@ -475,7 +491,7 @@ driveFilesCmd
   .option('--folder <id>', 'List files in folder')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       let result;
       if (opts.folder) {
         result = await client.drive.listFilesInFolder(opts.folder, {
@@ -499,7 +515,7 @@ driveFilesCmd
   .description('Get file metadata')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.getFile(id);
       print(result, getFormat(driveFilesCmd));
     } catch (err) {
@@ -517,7 +533,7 @@ driveFilesCmd
   .option('--content <content>', 'File content')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.createFile({
         name: opts.name,
         parents: opts.parent ? [opts.parent] : undefined,
@@ -538,7 +554,7 @@ driveFilesCmd
   .option('--parent <id>', 'Parent folder ID')
   .action(async (name: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.createFolder(name, {
         parents: opts.parent ? [opts.parent] : undefined,
       });
@@ -558,7 +574,7 @@ driveFilesCmd
   .option('--starred', 'Star the file')
   .action(async (id: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.updateFile(id, {
         name: opts.name,
         description: opts.description,
@@ -577,7 +593,7 @@ driveFilesCmd
   .description('Delete a file permanently')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.drive.deleteFile(id);
       success(`File ${id} deleted`);
     } catch (err) {
@@ -591,7 +607,7 @@ driveFilesCmd
   .description('Move a file to trash')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.drive.trashFile(id);
       success(`File ${id} moved to trash`);
     } catch (err) {
@@ -606,7 +622,7 @@ driveFilesCmd
   .option('--name <name>', 'New name for the copy')
   .action(async (id: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.copyFile(id, { name: opts.name });
       success('File copied!');
       print(result, getFormat(driveFilesCmd));
@@ -626,7 +642,7 @@ drivePermissionsCmd
   .description('List permissions for a file')
   .action(async (fileId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.listPermissions(fileId);
       print(result, getFormat(drivePermissionsCmd));
     } catch (err) {
@@ -645,7 +661,7 @@ drivePermissionsCmd
   .option('--notify', 'Send notification email')
   .action(async (fileId: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.drive.createPermission(fileId, {
         type: opts.type,
         role: opts.role,
@@ -666,7 +682,7 @@ drivePermissionsCmd
   .description('Remove a permission')
   .action(async (fileId: string, permissionId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.drive.deletePermission(fileId, permissionId);
       success('Permission deleted');
     } catch (err) {
@@ -692,7 +708,7 @@ calendarListCmd
   .description('List calendars')
   .action(async () => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.listCalendars();
       print(result, getFormat(calendarListCmd));
     } catch (err) {
@@ -706,7 +722,7 @@ calendarListCmd
   .description('Get a calendar')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.getCalendar(id);
       print(result, getFormat(calendarListCmd));
     } catch (err) {
@@ -722,7 +738,7 @@ calendarListCmd
   .option('--timezone <tz>', 'Time zone')
   .action(async (summary: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.createCalendar(summary, {
         description: opts.description,
         timeZone: opts.timezone,
@@ -740,7 +756,7 @@ calendarListCmd
   .description('Delete a calendar')
   .action(async (id: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.calendar.deleteCalendar(id);
       success(`Calendar ${id} deleted`);
     } catch (err) {
@@ -763,7 +779,7 @@ calendarEventsCmd
   .option('-q, --query <query>', 'Search query')
   .action(async (calendarId: string = 'primary', opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.listEvents(calendarId, {
         maxResults: parseInt(opts.max),
         timeMin: opts.from,
@@ -784,7 +800,7 @@ calendarEventsCmd
   .description('List today\'s events')
   .action(async (calendarId: string = 'primary') => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.getTodayEvents(calendarId);
       print(result, getFormat(calendarEventsCmd));
     } catch (err) {
@@ -798,7 +814,7 @@ calendarEventsCmd
   .description('List this week\'s events')
   .action(async (calendarId: string = 'primary') => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.getWeekEvents(calendarId);
       print(result, getFormat(calendarEventsCmd));
     } catch (err) {
@@ -812,7 +828,7 @@ calendarEventsCmd
   .description('Get an event')
   .action(async (eventId: string, calendarId: string = 'primary') => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.getEvent(calendarId, eventId);
       print(result, getFormat(calendarEventsCmd));
     } catch (err) {
@@ -833,7 +849,7 @@ calendarEventsCmd
   .option('--attendees <emails>', 'Attendee emails (comma-separated)')
   .action(async (calendarId: string = 'primary', opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       let result;
 
       if (opts.date) {
@@ -873,7 +889,7 @@ calendarEventsCmd
   .description('Quick add an event using natural language')
   .action(async (text: string, calendarId: string = 'primary') => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.quickAddEvent(calendarId, text);
       success('Event created!');
       print(result, getFormat(calendarEventsCmd));
@@ -891,7 +907,7 @@ calendarEventsCmd
   .option('--location <location>', 'Event location')
   .action(async (eventId: string, calendarId: string = 'primary', opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.calendar.updateEvent(calendarId, eventId, {
         summary: opts.summary,
         description: opts.description,
@@ -910,7 +926,7 @@ calendarEventsCmd
   .description('Delete an event')
   .action(async (eventId: string, calendarId: string = 'primary') => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.calendar.deleteEvent(calendarId, eventId);
       success('Event deleted');
     } catch (err) {
@@ -931,7 +947,7 @@ docsCmd
   .description('Create a new document')
   .action(async (title: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.docs.createDocument({ title });
       success('Document created!');
       print(result, getFormat(docsCmd));
@@ -946,7 +962,7 @@ docsCmd
   .description('Get a document')
   .action(async (documentId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.docs.getDocument(documentId);
       print(result, getFormat(docsCmd));
     } catch (err) {
@@ -960,7 +976,7 @@ docsCmd
   .description('Read document content as plain text')
   .action(async (documentId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const doc = await client.docs.getDocument(documentId);
       const text = client.docs.extractPlainText(doc);
       console.log(text);
@@ -975,7 +991,7 @@ docsCmd
   .description('Append text to a document')
   .action(async (documentId: string, text: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.docs.appendText(documentId, text);
       success('Text appended to document');
     } catch (err) {
@@ -992,7 +1008,7 @@ docsCmd
   .option('--match-case', 'Case-sensitive matching')
   .action(async (documentId: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.docs.replaceAllText(documentId, opts.find, opts.replace, opts.matchCase);
       success('Text replaced');
       print(result, getFormat(docsCmd));
@@ -1010,7 +1026,7 @@ docsCmd
   .option('--height <height>', 'Image height in points')
   .action(async (documentId: string, imageUri: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.docs.insertImage(documentId, imageUri, {
         index: opts.index ? parseInt(opts.index) : undefined,
         width: opts.width ? parseInt(opts.width) : undefined,
@@ -1031,7 +1047,7 @@ docsCmd
   .option('--index <index>', 'Insert position')
   .action(async (documentId: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.docs.insertTable(documentId, parseInt(opts.rows), parseInt(opts.cols), {
         index: opts.index ? parseInt(opts.index) : undefined,
       });
@@ -1054,7 +1070,7 @@ sheetsCmd
   .description('Create a new spreadsheet')
   .action(async (title: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.sheets.createSpreadsheet({ title });
       success('Spreadsheet created!');
       print(result, getFormat(sheetsCmd));
@@ -1069,7 +1085,7 @@ sheetsCmd
   .description('Get spreadsheet metadata')
   .action(async (spreadsheetId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.sheets.getSpreadsheetMetadata(spreadsheetId);
       print(result, getFormat(sheetsCmd));
     } catch (err) {
@@ -1083,7 +1099,7 @@ sheetsCmd
   .description('List sheet names in a spreadsheet')
   .action(async (spreadsheetId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const names = await client.sheets.getSheetNames(spreadsheetId);
       print(names, getFormat(sheetsCmd));
     } catch (err) {
@@ -1097,7 +1113,7 @@ sheetsCmd
   .description('Read values from a range')
   .action(async (spreadsheetId: string, range: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.sheets.getValues(spreadsheetId, range);
       print(result, getFormat(sheetsCmd));
     } catch (err) {
@@ -1112,7 +1128,7 @@ sheetsCmd
   .requiredOption('--values <json>', 'Values as JSON array (e.g., \'[["A", "B"], ["1", "2"]]\')')
   .action(async (spreadsheetId: string, range: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const values = JSON.parse(opts.values);
       const result = await client.sheets.updateValues(spreadsheetId, range, values);
       success('Values written!');
@@ -1129,7 +1145,7 @@ sheetsCmd
   .requiredOption('--values <json>', 'Values as JSON array')
   .action(async (spreadsheetId: string, range: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const values = JSON.parse(opts.values);
       const result = await client.sheets.appendValues(spreadsheetId, range, values);
       success('Values appended!');
@@ -1146,7 +1162,7 @@ sheetsCmd
   .requiredOption('--row <json>', 'Row values as JSON array (e.g., \'["value1", "value2"]\')')
   .action(async (spreadsheetId: string, sheetName: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const row = JSON.parse(opts.row);
       const result = await client.sheets.appendRow(spreadsheetId, sheetName, row);
       success('Row appended!');
@@ -1162,7 +1178,7 @@ sheetsCmd
   .description('Clear values from a range')
   .action(async (spreadsheetId: string, range: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.sheets.clearValues(spreadsheetId, range);
       success('Values cleared!');
       print(result, getFormat(sheetsCmd));
@@ -1177,7 +1193,7 @@ sheetsCmd
   .description('Get a single cell value')
   .action(async (spreadsheetId: string, sheetName: string, cell: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const value = await client.sheets.getCellValue(spreadsheetId, sheetName, cell);
       console.log(value);
     } catch (err) {
@@ -1191,7 +1207,7 @@ sheetsCmd
   .description('Set a single cell value')
   .action(async (spreadsheetId: string, sheetName: string, cell: string, value: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.sheets.setCellValue(spreadsheetId, sheetName, cell, value);
       success('Cell value set!');
     } catch (err) {
@@ -1205,7 +1221,7 @@ sheetsCmd
   .description('Get a row by index (1-based)')
   .action(async (spreadsheetId: string, sheetName: string, rowIndex: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const row = await client.sheets.getRow(spreadsheetId, sheetName, parseInt(rowIndex));
       print(row, getFormat(sheetsCmd));
     } catch (err) {
@@ -1219,7 +1235,7 @@ sheetsCmd
   .description('Get a column by letter')
   .action(async (spreadsheetId: string, sheetName: string, column: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const col = await client.sheets.getColumn(spreadsheetId, sheetName, column);
       print(col, getFormat(sheetsCmd));
     } catch (err) {

package/connectors/connect-googlecalendar/src/cli/index.ts

@@ -66,22 +66,17 @@ function getFormat(cmd: Command): OutputFormat {
 async function getClient(): Promise<GoogleCalendar> {
   let accessToken = getAccessToken();
 
-  if (!accessToken) {
-    error(`No access token configured. Run "${CONNECTOR_NAME} auth login" to authenticate or set GOOGLE_CALENDAR_ACCESS_TOKEN environment variable.`);
-    process.exit(1);
-  }
-
-  // Check if token is expired and we have refresh token
-  if (isTokenExpired()) {
+  // If no access token or token is expired, try to refresh using refresh token
+  if (!accessToken || isTokenExpired()) {
     const refreshToken = getRefreshToken();
     const clientId = getClientId();
     const clientSecret = getClientSecret();
 
     if (refreshToken && clientId && clientSecret) {
-      info('Access token expired, refreshing...');
+      info(accessToken ? 'Access token expired, refreshing...' : 'No access token, attempting refresh...');
       try {
         const client = new GoogleCalendar({
-          accessToken,
+          accessToken: accessToken || '',
           refreshToken,
           clientId,
           clientSecret,
@@ -94,6 +89,12 @@ async function getClient(): Promise<GoogleCalendar> {
         warn(`Failed to refresh token: ${err}. You may need to re-authenticate.`);
       }
     }
+
+    // After refresh attempt, if still no access token, exit
+    if (!accessToken) {
+      error(`No access token configured. Run "${CONNECTOR_NAME} auth login" to authenticate or set GOOGLE_CALENDAR_ACCESS_TOKEN environment variable.`);
+      process.exit(1);
+    }
   }
 
   const refreshToken = getRefreshToken();

package/connectors/connect-googlecontacts/src/cli/index.ts

@@ -62,10 +62,10 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 // Helper to get authenticated client
-function getClient(): GoogleContacts {
+async function getClient(): Promise<GoogleContacts> {
   const clientId = getClientId();
   const clientSecret = getClientSecret();
-  const accessToken = getAccessToken();
+  let accessToken = getAccessToken();
   const refreshToken = getRefreshToken();
   const redirectUri = getRedirectUri();
 
@@ -74,9 +74,34 @@ function getClient(): GoogleContacts {
     process.exit(1);
   }
 
+  // If no access token, try to refresh using refresh token
   if (!accessToken) {
-    error(`No access token. Run "${CONNECTOR_NAME} auth login" to authenticate.`);
-    process.exit(1);
+    if (refreshToken) {
+      try {
+        info('No access token, attempting refresh...');
+        const client = new GoogleContacts({
+          clientId,
+          clientSecret,
+          accessToken: '',
+          refreshToken,
+          redirectUri,
+        });
+        const tokens = await client.refreshAccessToken();
+        saveTokens({
+          accessToken: tokens.accessToken,
+          refreshToken: tokens.refreshToken,
+          expiresIn: tokens.expiresIn,
+        });
+        accessToken = tokens.accessToken;
+        success('Token refreshed successfully');
+      } catch (err) {
+        error(`Failed to refresh token: ${err}. Run "${CONNECTOR_NAME} auth login" to re-authenticate.`);
+        process.exit(1);
+      }
+    } else {
+      error(`No access token. Run "${CONNECTOR_NAME} auth login" to authenticate.`);
+      process.exit(1);
+    }
   }
 
   return new GoogleContacts({
@@ -462,7 +487,7 @@ contactsCmd
   .option('--normalize', 'Output in normalized format')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.list({
         pageSize: parseInt(opts.max),
         pageToken: opts.pageToken,
@@ -491,7 +516,7 @@ contactsCmd
   .option('--normalize', 'Output in normalized format')
   .action(async (resourceName: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.get(resourceName);
 
       if (opts.normalize) {
@@ -516,7 +541,7 @@ contactsCmd
   .option('--title <title>', 'Job title')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.create({
         givenName: opts.givenName,
         familyName: opts.familyName,
@@ -547,7 +572,7 @@ contactsCmd
   .option('--title <title>', 'Job title')
   .action(async (resourceName: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.update(resourceName, {
         givenName: opts.givenName,
         familyName: opts.familyName,
@@ -572,7 +597,7 @@ contactsCmd
   .description('Delete a contact')
   .action(async (resourceName: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.contacts.delete(resourceName);
       success(`Contact ${resourceName} deleted.`);
     } catch (err) {
@@ -588,7 +613,7 @@ contactsCmd
   .option('--normalize', 'Output in normalized format')
   .action(async (query: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.search({
         query,
         pageSize: parseInt(opts.max),
@@ -613,7 +638,7 @@ contactsCmd
   .option('--normalize', 'Export in normalized format')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const file = Bun.file(opts.output);
       const writer = file.writer();
 
@@ -641,7 +666,7 @@ contactsCmd
   .option('-n, --max <number>', 'Maximum results', '100')
   .action(async (opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.contacts.listGroups(parseInt(opts.max));
       print(result, getFormat(contactsCmd));
     } catch (err) {

package/connectors/connect-googledocs/src/cli/index.ts

@@ -7,6 +7,8 @@ import {
   setApiKey,
   getAccessToken,
   setAccessToken,
+  getRefreshToken,
+  getValidAccessToken,
   clearConfig,
   getConfigDir,
   setProfileOverride,
@@ -60,13 +62,27 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 // Helper to get authenticated client
-function getClient(): GoogleDocs {
-  const accessToken = getAccessToken();
+async function getClient(): Promise<GoogleDocs> {
+  let accessToken = getAccessToken();
   const apiKey = getApiKey();
+
+  // If no access token, try to refresh using refresh token
   if (!accessToken && !apiKey) {
-    error(`No credentials configured. Run "${CONNECTOR_NAME} config set-token <token>" or set GOOGLE_ACCESS_TOKEN environment variable.`);
-    process.exit(1);
+    const refreshToken = getRefreshToken();
+    if (refreshToken) {
+      try {
+        accessToken = await getValidAccessToken();
+      } catch {
+        // Fall through to error below
+      }
+    }
+
+    if (!accessToken) {
+      error(`No credentials configured. Run "${CONNECTOR_NAME} config set-token <token>" or set GOOGLE_ACCESS_TOKEN environment variable.`);
+      process.exit(1);
+    }
   }
+
   return new GoogleDocs({ accessToken, apiKey });
 }
 
@@ -215,7 +231,7 @@ program
   .description('Get a document by ID')
   .action(async (documentId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const result = await client.documents.get(documentId);
       print(result, getFormat(program));
     } catch (err) {
@@ -229,7 +245,7 @@ program
   .description('Create a new document (requires OAuth token)')
   .action(async (title: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Creating documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);
@@ -248,7 +264,7 @@ program
   .description('Append text to the end of a document (requires OAuth token)')
   .action(async (documentId: string, text: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Modifying documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);
@@ -268,7 +284,7 @@ program
   .option('--match-case', 'Match case when finding text')
   .action(async (documentId: string, find: string, replace: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Modifying documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);
@@ -292,7 +308,7 @@ program
   .description('Insert text at a specific position (requires OAuth token)')
   .action(async (documentId: string, text: string, index: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Modifying documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);
@@ -316,7 +332,7 @@ program
   .description('Delete content within a range (requires OAuth token)')
   .action(async (documentId: string, startIndex: string, endIndex: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Modifying documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);
@@ -341,7 +357,7 @@ program
   .description('Insert an image at a specific position (requires OAuth token)')
   .action(async (documentId: string, uri: string, index: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       if (!client.hasWriteAccess()) {
         error('Modifying documents requires an OAuth access token. API key provides read-only access.');
         process.exit(1);

package/connectors/connect-googledrive/src/cli/index.ts

@@ -56,7 +56,11 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 function requireAuth(): Drive {
-  if (!isAuthenticated()) {
+  // isAuthenticated() checks for both accessToken and refreshToken.
+  // If accessToken is missing/expired but refreshToken exists, the client's
+  // getValidAccessToken() will handle the refresh automatically.
+  const tokens = loadTokens();
+  if (!tokens || (!tokens.accessToken && !tokens.refreshToken)) {
     error('Not authenticated. Run "connect-googledrive auth login" first.');
     process.exit(1);
   }

package/connectors/connect-googlesheets/src/cli/index.ts

@@ -67,16 +67,29 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 // Helper to get authenticated client
-function getClient(): GoogleSheets {
+async function getClient(): Promise<GoogleSheets> {
   const apiKey = getApiKey();
-  const accessToken = getAccessToken();
+  let accessToken = getAccessToken();
   const refreshToken = getRefreshToken();
   const clientId = getClientId();
   const clientSecret = getClientSecret();
 
+  // If no API key and no access token, try to refresh using refresh token
   if (!apiKey && !accessToken) {
-    error(`No credentials configured. Run "${CONNECTOR_NAME} config set-key <key>" for API key auth or "${CONNECTOR_NAME} config set-token <token>" for OAuth.`);
-    process.exit(1);
+    if (refreshToken && clientId && clientSecret) {
+      try {
+        info('No access token, attempting refresh...');
+        const tempClient = new GoogleSheets({ refreshToken, clientId, clientSecret });
+        accessToken = await tempClient.refreshAccessToken();
+        success('Token refreshed successfully');
+      } catch (err) {
+        error(`Failed to refresh token: ${err}. Run "${CONNECTOR_NAME} config set-token <token>" to re-authenticate.`);
+        process.exit(1);
+      }
+    } else {
+      error(`No credentials configured. Run "${CONNECTOR_NAME} config set-key <key>" for API key auth or "${CONNECTOR_NAME} config set-token <token>" for OAuth.`);
+      process.exit(1);
+    }
   }
 
   return new GoogleSheets({
@@ -265,7 +278,7 @@ program
   .option('--formulas', 'Return formulas instead of calculated values')
   .action(async (spreadsheetId: string, range: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const valueRenderOption = opts.formulas ? 'FORMULA' : opts.raw ? 'UNFORMATTED_VALUE' : 'FORMATTED_VALUE';
 
       const result = await client.values.get(spreadsheetId, range, {
@@ -285,7 +298,7 @@ program
   .option('--raw', 'Use RAW input (no formula parsing)')
   .action(async (spreadsheetId: string, range: string, valuesStr: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Writing requires OAuth authentication. Use "config set-token" to configure OAuth.');
@@ -314,7 +327,7 @@ program
   .option('--overwrite', 'Overwrite existing data instead of inserting rows')
   .action(async (spreadsheetId: string, range: string, valuesStr: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Writing requires OAuth authentication. Use "config set-token" to configure OAuth.');
@@ -345,7 +358,7 @@ program
   .option('--timezone <tz>', 'Spreadsheet timezone (e.g., "America/New_York")')
   .action(async (title: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Creating spreadsheets requires OAuth authentication. Use "config set-token" to configure OAuth.');
@@ -372,7 +385,7 @@ program
   .description('List all sheets in a spreadsheet')
   .action(async (spreadsheetId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const spreadsheet = await client.spreadsheets.get(spreadsheetId);
 
       console.log(chalk.bold(`Spreadsheet: ${spreadsheet.properties.title}`));
@@ -404,7 +417,7 @@ program
   .description('Get spreadsheet metadata')
   .action(async (spreadsheetId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
       const spreadsheet = await client.spreadsheets.get(spreadsheetId);
 
       print(spreadsheet, getFormat(program));
@@ -419,7 +432,7 @@ program
   .description('Clear values from a range')
   .action(async (spreadsheetId: string, range: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Clearing values requires OAuth authentication. Use "config set-token" to configure OAuth.');
@@ -448,7 +461,7 @@ sheetCmd
   .option('--index <index>', 'Position to insert the sheet')
   .action(async (spreadsheetId: string, title: string, opts) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Adding sheets requires OAuth authentication.');
@@ -477,7 +490,7 @@ sheetCmd
   .description('Delete a sheet from a spreadsheet')
   .action(async (spreadsheetId: string, sheetIdStr: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Deleting sheets requires OAuth authentication.');
@@ -499,7 +512,7 @@ sheetCmd
   .description('Rename a sheet')
   .action(async (spreadsheetId: string, sheetIdStr: string, newTitle: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Renaming sheets requires OAuth authentication.');
@@ -521,7 +534,7 @@ sheetCmd
   .description('Copy a sheet to another spreadsheet')
   .action(async (spreadsheetId: string, sheetIdStr: string, destSpreadsheetId: string) => {
     try {
-      const client = getClient();
+      const client = await getClient();
 
       if (client.isApiKeyAuth()) {
         error('Copying sheets requires OAuth authentication.');

package/connectors/connect-googletasks/src/cli/index.ts

@@ -16,6 +16,7 @@ import {
   setTokens,
   getAccessToken,
   getRefreshToken,
+  isTokenExpired,
   clearTokens,
   loadProfile,
 } from '../utils/config';
@@ -40,11 +41,30 @@ function getFormat(cmd: Command): OutputFormat {
 }
 
 // Helper to get client
-function getClient(): GoogleTasksClient {
-  const token = getAccessToken();
-  if (!token) {
-    throw new Error('Not authenticated. Run "connect-googletasks auth login" first.');
+async function getClient(): Promise<GoogleTasksClient> {
+  let token = getAccessToken();
+
+  // If no access token or token is expired, try to refresh using refresh token
+  if (!token || isTokenExpired()) {
+    const refreshToken = getRefreshToken();
+    const clientId = getClientId();
+    const clientSecret = getClientSecret();
+
+    if (refreshToken && clientId && clientSecret) {
+      try {
+        const tokens = await GoogleTasksClient.refreshAccessToken(refreshToken, clientId, clientSecret);
+        setTokens(tokens.access_token, tokens.refresh_token, tokens.expires_in);
+        token = tokens.access_token;
+      } catch {
+        // Fall through to error below if refresh fails
+      }
+    }
+
+    if (!token) {
+      throw new Error('Not authenticated. Run "connect-googletasks auth login" first.');
+    }
   }
+
   return new GoogleTasksClient(token);
 }
 
@@ -307,7 +327,7 @@ listsCmd
   .description('List all task lists')
   .action(async function(this: Command) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const response = await client.listTaskLists();
       printTaskLists(response.items || [], getFormat(this));
     } catch (err) {
@@ -321,7 +341,7 @@ listsCmd
   .description('Get a task list by ID')
   .action(async function(this: Command, listId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const list = await client.getTaskList(listId);
       printTaskList(list, getFormat(this));
     } catch (err) {
@@ -335,7 +355,7 @@ listsCmd
   .description('Create a new task list')
   .action(async function(this: Command, title: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const list = await client.createTaskList({ title });
       success(`Task list "${list.title}" created`);
       printTaskList(list, getFormat(this));
@@ -350,7 +370,7 @@ listsCmd
   .description('Rename a task list')
   .action(async function(this: Command, listId: string, title: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const list = await client.updateTaskList(listId, { title });
       success(`Task list renamed to "${list.title}"`);
     } catch (err) {
@@ -364,7 +384,7 @@ listsCmd
   .description('Delete a task list')
   .action(async function(this: Command, listId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.deleteTaskList(listId);
       success('Task list deleted');
     } catch (err) {
@@ -389,7 +409,7 @@ tasksCmd
   .option('--max <number>', 'Maximum number of tasks', '100')
   .action(async function(this: Command, listId: string, opts) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const response = await client.listTasks(listId, {
         maxResults: parseInt(opts.max),
         showCompleted: opts.all || opts.completed,
@@ -408,7 +428,7 @@ tasksCmd
   .description('Get a task by ID')
   .action(async function(this: Command, listId: string, taskId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.getTask(listId, taskId);
       printTask(task, getFormat(this));
     } catch (err) {
@@ -424,7 +444,7 @@ tasksCmd
   .option('-d, --due <date>', 'Due date (YYYY-MM-DD)')
   .action(async function(this: Command, listId: string, title: string, opts) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.createTask(listId, {
         title,
         notes: opts.notes,
@@ -446,7 +466,7 @@ tasksCmd
   .option('-d, --due <date>', 'New due date (YYYY-MM-DD)')
   .action(async function(this: Command, listId: string, taskId: string, opts) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.updateTask(listId, taskId, {
         title: opts.title,
         notes: opts.notes,
@@ -466,7 +486,7 @@ tasksCmd
   .description('Mark a task as completed')
   .action(async function(this: Command, listId: string, taskId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.completeTask(listId, taskId);
       success(`Task "${task.title}" marked as completed`);
     } catch (err) {
@@ -481,7 +501,7 @@ tasksCmd
   .description('Mark a task as not completed')
   .action(async function(this: Command, listId: string, taskId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.uncompleteTask(listId, taskId);
       success(`Task "${task.title}" marked as needs action`);
     } catch (err) {
@@ -496,7 +516,7 @@ tasksCmd
   .description('Delete a task')
   .action(async function(this: Command, listId: string, taskId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.deleteTask(listId, taskId);
       success('Task deleted');
     } catch (err) {
@@ -512,7 +532,7 @@ tasksCmd
   .option('--after <taskId>', 'Position after this task')
   .action(async function(this: Command, listId: string, taskId: string, opts) {
     try {
-      const client = getClient();
+      const client = await getClient();
       const task = await client.moveTask(listId, taskId, {
         parent: opts.parent,
         previous: opts.after,
@@ -529,7 +549,7 @@ tasksCmd
   .description('Clear all completed tasks from a list')
   .action(async function(this: Command, listId: string) {
     try {
-      const client = getClient();
+      const client = await getClient();
       await client.clearCompleted(listId);
       success('Completed tasks cleared');
     } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {