mcp-sunsama 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # mcp-sunsama
 
+## 0.14.1
+
+### Patch Changes
+
+- fix: resolve stdio authentication race condition
+
+  Fixes critical race condition in stdio authentication that caused "Global Sunsama client not initialized" errors and -32800 request cancelled errors in Raycast and other MCP clients. Implements lazy authentication with promise caching to prevent concurrent auth attempts and adds graceful startup error handling.
+
 ## 0.14.0
 
 ### Minor Changes

package/dist/auth/stdio.d.ts

@@ -3,11 +3,11 @@ import { SunsamaClient } from "sunsama-api";
  * Initialize stdio authentication using environment variables
  * @throws {Error} If credentials are missing or authentication fails
  */
-export declare function initializeStdioAuth(): Promise<void>;
+export declare function initializeStdioAuth(): Promise<SunsamaClient>;
 /**
  * Get the global Sunsama client instance for stdio transport
- * @returns {SunsamaClient} The authenticated global client
- * @throws {Error} If global client is not initialized
+ * @returns {Promise<SunsamaClient>} The authenticated global client
+ * @throws {Error} If credentials are missing or authentication fails
  */
-export declare function getGlobalSunsamaClient(): SunsamaClient;
+export declare function getGlobalSunsamaClient(): Promise<SunsamaClient>;
 //# sourceMappingURL=stdio.d.ts.map

package/dist/auth/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/auth/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CASzD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,aAAa,CAKtD"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/auth/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CAWlE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,aAAa,CAAC,CAMrE"}

package/dist/auth/stdio.js

@@ -1,8 +1,8 @@
 import { SunsamaClient } from "sunsama-api";
 /**
- * Global Sunsama client instance for stdio transport
+ * Cached authentication promise to prevent concurrent auth attempts
  */
-let globalSunsamaClient = null;
+let authenticationPromise = null;
 /**
  * Initialize stdio authentication using environment variables
  * @throws {Error} If credentials are missing or authentication fails
@@ -11,17 +11,18 @@ export async function initializeStdioAuth() {
     if (!process.env.SUNSAMA_EMAIL || !process.env.SUNSAMA_PASSWORD) {
         throw new Error("Sunsama credentials not configured. Please set SUNSAMA_EMAIL and SUNSAMA_PASSWORD environment variables.");
     }
-    globalSunsamaClient = new SunsamaClient();
-    await globalSunsamaClient.login(process.env.SUNSAMA_EMAIL, process.env.SUNSAMA_PASSWORD);
+    const sunsamaClient = new SunsamaClient();
+    await sunsamaClient.login(process.env.SUNSAMA_EMAIL, process.env.SUNSAMA_PASSWORD);
+    return sunsamaClient;
 }
 /**
  * Get the global Sunsama client instance for stdio transport
- * @returns {SunsamaClient} The authenticated global client
- * @throws {Error} If global client is not initialized
+ * @returns {Promise<SunsamaClient>} The authenticated global client
+ * @throws {Error} If credentials are missing or authentication fails
  */
-export function getGlobalSunsamaClient() {
-    if (!globalSunsamaClient) {
-        throw new Error("Global Sunsama client not initialized.");
+export async function getGlobalSunsamaClient() {
+    if (!authenticationPromise) {
+        authenticationPromise = initializeStdioAuth();
     }
-    return globalSunsamaClient;
+    return authenticationPromise;
 }

package/dist/main.js

@@ -7,13 +7,20 @@ import { allTools } from "./tools/index.js";
 import { apiDocumentationResource } from "./resources/index.js";
 // Get transport configuration with validation
 const transportConfig = getTransportConfig();
-// For stdio transport, authenticate at startup with environment variables
+// For stdio transport, attempt authentication at startup with environment variables
 if (transportConfig.transportType === "stdio") {
-    await initializeStdioAuth();
+    try {
+        await initializeStdioAuth();
+        console.log("Sunsama authentication successful");
+    }
+    catch (error) {
+        console.error("Failed to initialize Sunsama authentication:", error instanceof Error ? error.message : 'Unknown error');
+        console.error("Server will start but tools will retry authentication on first use");
+    }
 }
 const server = new FastMCP({
     name: "Sunsama API Server",
-    version: "0.14.0",
+    version: "0.14.1",
     instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/dist/tools/shared.d.ts

@@ -21,10 +21,6 @@ export declare function createToolWrapper<T>(config: {
     parameters: any;
     execute: (args: T, context: ToolContext) => Promise<any>;
 };
-/**
- * Gets the Sunsama client for the current session
- */
-export declare function getClient(session: SessionData | undefined | null): import("sunsama-api").SunsamaClient;
 /**
  * Formats data as JSON response
  */

package/dist/tools/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC1D;;;;oBAKyB,CAAC,WAAW,WAAW;EAchD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,uCAEhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CAS1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAS3D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,GAAG,EAAE,EACX,UAAU,EAAE;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,YAAY,CAYd"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC1D;;;;oBAKyB,CAAC,WAAW,WAAW;EAchD;AAGD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CAS1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAS3D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,GAAG,EAAE,EACX,UAAU,EAAE;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,YAAY,CAYd"}

package/dist/tools/shared.js

@@ -1,4 +1,3 @@
-import { getSunsamaClient } from "../utils/client-resolver.js";
 import { toTsv } from "../utils/to-tsv.js";
 /**
  * Creates a standardized tool execution wrapper with error handling and logging
@@ -24,12 +23,6 @@ export function createToolWrapper(config) {
         }
     };
 }
-/**
- * Gets the Sunsama client for the current session
- */
-export function getClient(session) {
-    return getSunsamaClient(session);
-}
 /**
  * Formats data as JSON response
  */

package/dist/tools/stream-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-tools.d.ts","sourceRoot":"","sources":["../../src/tools/stream-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhG,eAAO,MAAM,cAAc;;;;;CAczB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;GAAmB,CAAC"}
+{"version":3,"file":"stream-tools.d.ts","sourceRoot":"","sources":["../../src/tools/stream-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAErF,eAAO,MAAM,cAAc;;;;;CAczB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;GAAmB,CAAC"}

package/dist/tools/stream-tools.js

@@ -1,12 +1,13 @@
 import { getStreamsSchema } from "../schemas.js";
-import { createToolWrapper, getClient, formatTsvResponse } from "./shared.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
+import { createToolWrapper, formatTsvResponse } from "./shared.js";
 export const getStreamsTool = createToolWrapper({
     name: "get-streams",
     description: "Get streams for the user's group (streams are called 'channels' in the Sunsama UI)",
     parameters: getStreamsSchema,
     execute: async (_args, context) => {
         context.log.info("Getting streams for user's group");
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const streams = await sunsamaClient.getStreamsByGroupId();
         context.log.info("Successfully retrieved streams", { count: streams.length });
         return formatTsvResponse(streams);

package/dist/tools/task-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AAiCA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,mBAAmB;;;;;CAe9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;CAkC5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;CAsC/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;CAqB1B,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CA4CzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;CA2BzB,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;;;;;CA4BjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;CAkCnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;CAgChC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;CA4BpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAsC9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;CA6BhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;CAmC7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;CAiC/B,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBrB,CAAC"}
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AAkCA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,mBAAmB;;;;;CAe9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;CAkC5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;CAsC/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;CAqB1B,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CA4CzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;CA2BzB,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;;;;;CA4BjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;CAkCnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;CAgChC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;CA4BpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAsC9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;CA6BhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;CAmC7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;CAiC/B,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBrB,CAAC"}

package/dist/tools/task-tools.js

@@ -1,7 +1,8 @@
 import { createTaskSchema, deleteTaskSchema, getArchivedTasksSchema, getTaskByIdSchema, getTasksBacklogSchema, getTasksByDaySchema, updateTaskBacklogSchema, updateTaskCompleteSchema, updateTaskDueDateSchema, updateTaskNotesSchema, updateTaskPlannedTimeSchema, updateTaskSnoozeDateSchema, updateTaskStreamSchema, updateTaskTextSchema } from "../schemas.js";
 import { filterTasksByCompletion } from "../utils/task-filters.js";
 import { trimTasksForResponse } from "../utils/task-trimmer.js";
-import { createToolWrapper, getClient, formatJsonResponse, formatTsvResponse, formatPaginatedTsvResponse } from "./shared.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
+import { createToolWrapper, formatJsonResponse, formatTsvResponse, formatPaginatedTsvResponse } from "./shared.js";
 // Task Query Tools
 export const getTasksBacklogTool = createToolWrapper({
     name: "get-tasks-backlog",
@@ -9,7 +10,7 @@ export const getTasksBacklogTool = createToolWrapper({
     parameters: getTasksBacklogSchema,
     execute: async (_args, context) => {
         context.log.info("Getting backlog tasks");
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const tasks = await sunsamaClient.getTasksBacklog();
         const trimmedTasks = trimTasksForResponse(tasks);
         context.log.info("Successfully retrieved backlog tasks", { count: tasks.length });
@@ -26,7 +27,7 @@ export const getTasksByDayTool = createToolWrapper({
             timezone,
             completionFilter
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         // If no timezone provided, get the user's default timezone
         let resolvedTimezone = timezone;
         if (!resolvedTimezone) {
@@ -58,7 +59,7 @@ export const getArchivedTasksTool = createToolWrapper({
             requestedLimit,
             fetchLimit
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const allTasks = await sunsamaClient.getArchivedTasks(offset, fetchLimit);
         const hasMore = allTasks.length > requestedLimit;
         const tasks = hasMore ? allTasks.slice(0, requestedLimit) : allTasks;
@@ -85,7 +86,7 @@ export const getTaskByIdTool = createToolWrapper({
     parameters: getTaskByIdSchema,
     execute: async ({ taskId }, context) => {
         context.log.info("Getting task by ID", { taskId });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const task = await sunsamaClient.getTaskById(taskId);
         if (task) {
             context.log.info("Successfully retrieved task by ID", {
@@ -116,7 +117,7 @@ export const createTaskTool = createToolWrapper({
             isPrivate: isPrivate,
             customTaskId: !!taskId
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const options = {};
         if (notes)
             options.notes = notes;
@@ -157,7 +158,7 @@ export const deleteTaskTool = createToolWrapper({
             limitResponsePayload,
             wasTaskMerged
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const result = await sunsamaClient.deleteTask(taskId, limitResponsePayload, wasTaskMerged);
         context.log.info("Successfully deleted task", {
             taskId,
@@ -182,7 +183,7 @@ export const updateTaskCompleteTool = createToolWrapper({
             hasCustomCompleteOn: !!completeOn,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const result = await sunsamaClient.updateTaskComplete(taskId, completeOn, limitResponsePayload);
         context.log.info("Successfully marked task as complete", {
             taskId,
@@ -208,7 +209,7 @@ export const updateTaskSnoozeDateTool = createToolWrapper({
             timezone,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const options = {};
         if (timezone)
             options.timezone = timezone;
@@ -238,7 +239,7 @@ export const updateTaskBacklogTool = createToolWrapper({
             timezone,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const options = {};
         if (timezone)
             options.timezone = timezone;
@@ -267,7 +268,7 @@ export const updateTaskPlannedTimeTool = createToolWrapper({
             timeEstimateMinutes,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const result = await sunsamaClient.updateTaskPlannedTime(taskId, timeEstimateMinutes, limitResponsePayload);
         context.log.info("Successfully updated task planned time", {
             taskId,
@@ -296,7 +297,7 @@ export const updateTaskNotesTool = createToolWrapper({
             contentLength: content.value.length,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const options = {};
         if (limitResponsePayload !== undefined)
             options.limitResponsePayload = limitResponsePayload;
@@ -325,7 +326,7 @@ export const updateTaskDueDateTool = createToolWrapper({
             dueDate,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const result = await sunsamaClient.updateTaskDueDate(taskId, dueDate, limitResponsePayload);
         context.log.info("Successfully updated task due date", {
             taskId,
@@ -352,7 +353,7 @@ export const updateTaskTextTool = createToolWrapper({
             recommendedStreamId,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const options = {};
         if (recommendedStreamId !== undefined)
             options.recommendedStreamId = recommendedStreamId;
@@ -383,7 +384,7 @@ export const updateTaskStreamTool = createToolWrapper({
             streamId,
             limitResponsePayload
         });
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const result = await sunsamaClient.updateTaskStream(taskId, streamId, limitResponsePayload !== undefined ? limitResponsePayload : true);
         context.log.info("Successfully updated task stream assignment", {
             taskId,

package/dist/tools/user-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../src/tools/user-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjG,eAAO,MAAM,WAAW;;;;;CActB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;GAAgB,CAAC"}
+{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../src/tools/user-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtF,eAAO,MAAM,WAAW;;;;;CActB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;GAAgB,CAAC"}

package/dist/tools/user-tools.js

@@ -1,12 +1,13 @@
 import { getUserSchema } from "../schemas.js";
-import { createToolWrapper, getClient, formatJsonResponse } from "./shared.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
+import { createToolWrapper, formatJsonResponse } from "./shared.js";
 export const getUserTool = createToolWrapper({
     name: "get-user",
     description: "Get current user information including profile, timezone, and group details",
     parameters: getUserSchema,
     execute: async (_args, context) => {
         context.log.info("Getting user information");
-        const sunsamaClient = getClient(context.session);
+        const sunsamaClient = await getSunsamaClient(context.session);
         const user = await sunsamaClient.getUser();
         context.log.info("Successfully retrieved user information", { userId: user._id });
         return formatJsonResponse(user);

package/dist/utils/client-resolver.d.ts

@@ -2,9 +2,9 @@ import { SunsamaClient } from "sunsama-api";
 import type { SessionData } from "../auth/types.js";
 /**
  * Gets the appropriate SunsamaClient instance based on transport type
- * @param session - Session data for HTTP transport (null for stdio)
- * @returns Authenticated SunsamaClient instance
+ * @param session - Session data for HTTP transport (undefined/null for stdio)
+ * @returns Promise<SunsamaClient> Authenticated SunsamaClient instance
  * @throws {Error} If session is not available for HTTP transport or global client not initialized for stdio
  */
-export declare function getSunsamaClient(session: SessionData | null): SunsamaClient;
+export declare function getSunsamaClient(session?: SessionData | null): Promise<SunsamaClient>;
 //# sourceMappingURL=client-resolver.d.ts.map

package/dist/utils/client-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,CAW3E"}
+{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAW3F"}

package/dist/utils/client-resolver.js

@@ -3,11 +3,11 @@ import { getGlobalSunsamaClient } from "../auth/stdio.js";
 import { getTransportConfig } from "../config/transport.js";
 /**
  * Gets the appropriate SunsamaClient instance based on transport type
- * @param session - Session data for HTTP transport (null for stdio)
- * @returns Authenticated SunsamaClient instance
+ * @param session - Session data for HTTP transport (undefined/null for stdio)
+ * @returns Promise<SunsamaClient> Authenticated SunsamaClient instance
  * @throws {Error} If session is not available for HTTP transport or global client not initialized for stdio
  */
-export function getSunsamaClient(session) {
+export async function getSunsamaClient(session) {
     const transportConfig = getTransportConfig();
     if (transportConfig.transportType === "httpStream") {
         if (!session?.sunsamaClient) {
@@ -15,5 +15,5 @@ export function getSunsamaClient(session) {
         }
         return session.sunsamaClient;
     }
-    return getGlobalSunsamaClient();
+    return await getGlobalSunsamaClient();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-sunsama",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "MCP server for Sunsama API integration",
   "type": "module",
   "private": false,

package/src/auth/stdio.ts

@@ -1,33 +1,36 @@
 import { SunsamaClient } from "sunsama-api";
 
 /**
- * Global Sunsama client instance for stdio transport
+ * Cached authentication promise to prevent concurrent auth attempts
  */
-let globalSunsamaClient: SunsamaClient | null = null;
+let authenticationPromise: Promise<SunsamaClient> | null = null;
 
 /**
  * Initialize stdio authentication using environment variables
  * @throws {Error} If credentials are missing or authentication fails
  */
-export async function initializeStdioAuth(): Promise<void> {
+export async function initializeStdioAuth(): Promise<SunsamaClient> {
   if (!process.env.SUNSAMA_EMAIL || !process.env.SUNSAMA_PASSWORD) {
     throw new Error(
       "Sunsama credentials not configured. Please set SUNSAMA_EMAIL and SUNSAMA_PASSWORD environment variables."
     );
   }
 
-  globalSunsamaClient = new SunsamaClient();
-  await globalSunsamaClient.login(process.env.SUNSAMA_EMAIL, process.env.SUNSAMA_PASSWORD);
+  const sunsamaClient = new SunsamaClient();
+  await sunsamaClient.login(process.env.SUNSAMA_EMAIL, process.env.SUNSAMA_PASSWORD);
+
+  return sunsamaClient;
 }
 
 /**
  * Get the global Sunsama client instance for stdio transport
- * @returns {SunsamaClient} The authenticated global client
- * @throws {Error} If global client is not initialized
+ * @returns {Promise<SunsamaClient>} The authenticated global client
+ * @throws {Error} If credentials are missing or authentication fails
  */
-export function getGlobalSunsamaClient(): SunsamaClient {
-  if (!globalSunsamaClient) {
-    throw new Error("Global Sunsama client not initialized.");
+export async function getGlobalSunsamaClient(): Promise<SunsamaClient> {
+  if (!authenticationPromise) {
+    authenticationPromise = initializeStdioAuth();
   }
-  return globalSunsamaClient;
+
+  return authenticationPromise;
 }

package/src/main.ts

@@ -9,14 +9,20 @@ import { apiDocumentationResource } from "./resources/index.js";
 // Get transport configuration with validation
 const transportConfig = getTransportConfig();
 
-// For stdio transport, authenticate at startup with environment variables
+// For stdio transport, attempt authentication at startup with environment variables
 if (transportConfig.transportType === "stdio") {
-  await initializeStdioAuth();
+  try {
+    await initializeStdioAuth();
+    console.log("Sunsama authentication successful");
+  } catch (error) {
+    console.error("Failed to initialize Sunsama authentication:", error instanceof Error ? error.message : 'Unknown error');
+    console.error("Server will start but tools will retry authentication on first use");
+  }
 }
 
 const server = new FastMCP({
   name: "Sunsama API Server",
-  version: "0.14.0",
+  version: "0.14.1",
   instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/src/tools/shared.ts

@@ -1,6 +1,5 @@
 import type { Context } from "fastmcp";
 import type { SessionData } from "../auth/types.js";
-import { getSunsamaClient } from "../utils/client-resolver.js";
 import { toTsv } from "../utils/to-tsv.js";
 
 export type ToolContext = Context<SessionData>;
@@ -41,12 +40,6 @@ export function createToolWrapper<T>(config: {
   };
 }
 
-/**
- * Gets the Sunsama client for the current session
- */
-export function getClient(session: SessionData | undefined | null) {
-  return getSunsamaClient(session as SessionData | null);
-}
 
 /**
  * Formats data as JSON response

package/src/tools/stream-tools.ts

@@ -1,5 +1,6 @@
 import { getStreamsSchema, type GetStreamsInput } from "../schemas.js";
-import { createToolWrapper, getClient, formatTsvResponse, type ToolContext } from "./shared.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
+import { createToolWrapper, formatTsvResponse, type ToolContext } from "./shared.js";
 
 export const getStreamsTool = createToolWrapper({
   name: "get-streams",
@@ -8,7 +9,7 @@ export const getStreamsTool = createToolWrapper({
   execute: async (_args: GetStreamsInput, context: ToolContext) => {
     context.log.info("Getting streams for user's group");
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const streams = await sunsamaClient.getStreamsByGroupId();
 
     context.log.info("Successfully retrieved streams", { count: streams.length });

package/src/tools/task-tools.ts

@@ -31,9 +31,9 @@ import {
 } from "../schemas.js";
 import { filterTasksByCompletion } from "../utils/task-filters.js";
 import { trimTasksForResponse } from "../utils/task-trimmer.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
 import {
   createToolWrapper,
-  getClient,
   formatJsonResponse,
   formatTsvResponse,
   formatPaginatedTsvResponse,
@@ -48,7 +48,7 @@ export const getTasksBacklogTool = createToolWrapper({
   execute: async (_args: GetTasksBacklogInput, context: ToolContext) => {
     context.log.info("Getting backlog tasks");
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const tasks = await sunsamaClient.getTasksBacklog();
     const trimmedTasks = trimTasksForResponse(tasks);
 
@@ -69,7 +69,7 @@ export const getTasksByDayTool = createToolWrapper({
       completionFilter
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     // If no timezone provided, get the user's default timezone
     let resolvedTimezone = timezone;
@@ -108,7 +108,7 @@ export const getArchivedTasksTool = createToolWrapper({
       fetchLimit
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const allTasks = await sunsamaClient.getArchivedTasks(offset, fetchLimit);
 
     const hasMore = allTasks.length > requestedLimit;
@@ -141,7 +141,7 @@ export const getTaskByIdTool = createToolWrapper({
   execute: async ({ taskId }: GetTaskByIdInput, context: ToolContext) => {
     context.log.info("Getting task by ID", { taskId });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const task = await sunsamaClient.getTaskById(taskId);
 
     if (task) {
@@ -175,7 +175,7 @@ export const createTaskTool = createToolWrapper({
       customTaskId: !!taskId
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     const options: CreateTaskOptions = {};
     if (notes) options.notes = notes;
@@ -216,7 +216,7 @@ export const deleteTaskTool = createToolWrapper({
       wasTaskMerged
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const result = await sunsamaClient.deleteTask(taskId, limitResponsePayload, wasTaskMerged);
 
     context.log.info("Successfully deleted task", {
@@ -246,7 +246,7 @@ export const updateTaskCompleteTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const result = await sunsamaClient.updateTaskComplete(taskId, completeOn, limitResponsePayload);
 
     context.log.info("Successfully marked task as complete", {
@@ -277,7 +277,7 @@ export const updateTaskSnoozeDateTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     const options: { timezone?: string; limitResponsePayload?: boolean } = {};
     if (timezone) options.timezone = timezone;
@@ -312,7 +312,7 @@ export const updateTaskBacklogTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     const options: { timezone?: string; limitResponsePayload?: boolean } = {};
     if (timezone) options.timezone = timezone;
@@ -346,7 +346,7 @@ export const updateTaskPlannedTimeTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const result = await sunsamaClient.updateTaskPlannedTime(taskId, timeEstimateMinutes, limitResponsePayload);
 
     context.log.info("Successfully updated task planned time", {
@@ -381,7 +381,7 @@ export const updateTaskNotesTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     const options: { limitResponsePayload?: boolean } = {};
     if (limitResponsePayload !== undefined) options.limitResponsePayload = limitResponsePayload;
@@ -416,7 +416,7 @@ export const updateTaskDueDateTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const result = await sunsamaClient.updateTaskDueDate(taskId, dueDate, limitResponsePayload);
 
     context.log.info("Successfully updated task due date", {
@@ -448,7 +448,7 @@ export const updateTaskTextTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
 
     const options: { recommendedStreamId?: string | null; limitResponsePayload?: boolean } = {};
     if (recommendedStreamId !== undefined) options.recommendedStreamId = recommendedStreamId;
@@ -484,7 +484,7 @@ export const updateTaskStreamTool = createToolWrapper({
       limitResponsePayload
     });
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const result = await sunsamaClient.updateTaskStream(
       taskId,
       streamId,

package/src/tools/user-tools.ts

@@ -1,5 +1,6 @@
 import { getUserSchema, type GetUserInput } from "../schemas.js";
-import { createToolWrapper, getClient, formatJsonResponse, type ToolContext } from "./shared.js";
+import { getSunsamaClient } from "../utils/client-resolver.js";
+import { createToolWrapper, formatJsonResponse, type ToolContext } from "./shared.js";
 
 export const getUserTool = createToolWrapper({
   name: "get-user",
@@ -8,7 +9,7 @@ export const getUserTool = createToolWrapper({
   execute: async (_args: GetUserInput, context: ToolContext) => {
     context.log.info("Getting user information");
 
-    const sunsamaClient = getClient(context.session);
+    const sunsamaClient = await getSunsamaClient(context.session);
     const user = await sunsamaClient.getUser();
 
     context.log.info("Successfully retrieved user information", { userId: user._id });

package/src/utils/client-resolver.ts

@@ -5,19 +5,19 @@ import { getTransportConfig } from "../config/transport.js";
 
 /**
  * Gets the appropriate SunsamaClient instance based on transport type
- * @param session - Session data for HTTP transport (null for stdio)
- * @returns Authenticated SunsamaClient instance
+ * @param session - Session data for HTTP transport (undefined/null for stdio)
+ * @returns Promise<SunsamaClient> Authenticated SunsamaClient instance
  * @throws {Error} If session is not available for HTTP transport or global client not initialized for stdio
  */
-export function getSunsamaClient(session: SessionData | null): SunsamaClient {
+export async function getSunsamaClient(session?: SessionData | null): Promise<SunsamaClient> {
   const transportConfig = getTransportConfig();
-  
+
   if (transportConfig.transportType === "httpStream") {
     if (!session?.sunsamaClient) {
       throw new Error("Session not available. Authentication may have failed.");
     }
     return session.sunsamaClient;
   }
-  
-  return getGlobalSunsamaClient();
+
+  return await getGlobalSunsamaClient();
 }