timezest-mcp 1.0.1 → 1.0.4

package/README.md

@@ -28,8 +28,8 @@ Add this entry to the `mcpServers` section:
 {
   "mcpServers": {
     "timezest": {
-      "command": "npx",
-      "args": ["-y", "timezest-mcp@latest"],
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "timezest-mcp@latest"],
       "env": {
         "TIMEZEST_API_KEY": "YOUR_API_KEY_HERE",
         "TIMEZEST_DEFAULT_TZ": "America/Chicago"
@@ -43,7 +43,7 @@ Add this entry to the `mcpServers` section:
 If you use the terminal-based **Claude Code**, run this single command to add the server globally:
 
 ```bash
-claude mcp add-json timezest "{\"type\": \"stdio\", \"command\": \"npx\", \"args\": [\"-y\", \"timezest-mcp@latest\"], \"env\": {\"TIMEZEST_API_KEY\": \"YOUR_API_KEY_HERE\", \"TIMEZEST_DEFAULT_TZ\": \"America/Chicago\"}}"
+claude mcp add-json timezest "{\"type\": \"stdio\", \"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"-y\", \"timezest-mcp@latest\"], \"env\": {\"TIMEZEST_API_KEY\": \"YOUR_API_KEY_HERE\", \"TIMEZEST_DEFAULT_TZ\": \"America/Chicago\"}}"
 ```
 
 ---

package/build/client.js

@@ -17,15 +17,27 @@ export class TimeZestClient {
                 headers: { Authorization: `Bearer ${this.apiKey}` }
             });
             const data = response.data;
+            // Handle both flat arrays and wrapped responses (e.g., { scheduling_requests: [...] })
+            let items;
             if (Array.isArray(data)) {
-                results.push(...data);
-                if (data.length < 50)
-                    break; // TimeZest pagination limit
+                items = data;
+            }
+            else if (data && typeof data === 'object') {
+                // Find the first array value in the response object
+                const arrayValue = Object.values(data).find(v => Array.isArray(v));
+                if (arrayValue) {
+                    items = arrayValue;
+                }
+                else {
+                    throw new Error(`Unexpected API response format from ${endpoint}: ${JSON.stringify(data).slice(0, 200)}`);
+                }
             }
             else {
-                // Unexpected format
-                break;
+                throw new Error(`Unexpected API response format from ${endpoint}: ${typeof data}`);
             }
+            results.push(...items);
+            if (items.length < 50)
+                break;
             page++;
         }
         return results;
@@ -41,17 +53,22 @@ export class TimeZestClient {
             return this.appointmentTypes;
         }
         catch (error) {
-            console.error('Error fetching appointment types:', error);
-            return new Map();
+            const status = error?.response?.status;
+            const msg = error?.response?.data?.message || error?.message || String(error);
+            throw new Error(`TimeZest API error fetching appointment types (HTTP ${status || 'unknown'}): ${msg}`);
         }
     }
     /**
-     * Fetches the standard 45-day window (14 days back, 30 forward) by created_at.
+     * Fetches scheduling requests for a configurable window by created_at.
+     * Falls back to env vars TIMEZEST_WINDOW_DAYS_BACK / TIMEZEST_WINDOW_DAYS_FORWARD,
+     * then to 14 / 30 defaults.
      */
-    async getStandardWindowRequests() {
+    async getSchedulingRequests(daysBack, daysForward) {
+        const back = daysBack ?? parseInt(process.env.TIMEZEST_WINDOW_DAYS_BACK || '14', 10);
+        const forward = daysForward ?? parseInt(process.env.TIMEZEST_WINDOW_DAYS_FORWARD || '30', 10);
         const now = new Date();
-        const start = subDays(now, 14);
-        const end = addDays(now, 30);
+        const start = subDays(now, back);
+        const end = addDays(now, forward);
         // API limits filters to created_at
         const params = {
             created_at_after: getUnixTime(start),
@@ -61,8 +78,9 @@ export class TimeZestClient {
             return await this.fetchAllPages('/scheduling_requests', params);
         }
         catch (error) {
-            console.error('Error fetching scheduling requests:', error);
-            return [];
+            const status = error?.response?.status;
+            const msg = error?.response?.data?.message || error?.message || String(error);
+            throw new Error(`TimeZest API error fetching scheduling requests (HTTP ${status || 'unknown'}): ${msg}`);
         }
     }
 }

package/build/index.js

@@ -116,10 +116,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
-    const appointmentTypes = await client.getAppointmentTypes();
-    const rawRequests = await client.getStandardWindowRequests();
+    let appointmentTypes;
+    let all;
     const tz = args?.timezone || process.env.TIMEZEST_DEFAULT_TZ || 'America/Chicago';
-    const all = rawRequests.map(r => transformAppointment(r, appointmentTypes, tz));
+    try {
+        appointmentTypes = await client.getAppointmentTypes();
+        // Determine fetch window from tool-specific args
+        const daysBack = args?.days_back;
+        const daysForward = args?.days_forward;
+        const rawRequests = await client.getSchedulingRequests(daysBack, daysForward);
+        all = rawRequests.map(r => transformAppointment(r, appointmentTypes, tz));
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true
+        };
+    }
     switch (name) {
         case "get_todays_appointments": {
             const today = new Date();

package/build/utils/filter.js

@@ -12,9 +12,11 @@ export function filterByDateRange(appointments, startDate, endDate) {
     const start = parseISO(startDate);
     const end = parseISO(endDate);
     return appointments.filter(a => {
-        if (!a.start_time)
+        // Use start_time for scheduled appointments, fall back to created_at for pending
+        const dateStr = a.start_time || a.created_at;
+        if (!dateStr)
             return false;
-        const date = parseISO(a.start_time);
+        const date = parseISO(dateStr);
         return isWithinInterval(date, { start, end });
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "timezest-mcp",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "MCP Server for TimeZest scheduling API — brings appointments, pending requests, and ticket-linked schedules to Claude.",
   "main": "build/index.js",
   "author": "Sagar Kalra",