mcp-sunsama 0.5.0 → 0.5.2

package/.claude/settings.local.json

@@ -19,7 +19,9 @@
       "Bash(cat:*)",
       "Bash(grep:*)",
       "Bash(mkdir:*)",
-      "mcp__fetch__fetch"
+      "mcp__fetch__fetch",
+      "Bash(npm view:*)",
+      "Bash(npm info:*)"
     ],
     "deny": []
   },

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # mcp-sunsama
 
+## 0.5.2
+
+### Patch Changes
+
+- Fix updateTaskSnoozeDate schema validation for null values by using proper union types
+
+## 0.5.1
+
+### Patch Changes
+
+- 005209d: Add prepublishOnly script to ensure build runs before publishing
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/main.js

@@ -3,7 +3,7 @@ import { FastMCP } from "fastmcp";
 import { httpStreamAuthenticator } from "./auth/http.js";
 import { initializeStdioAuth } from "./auth/stdio.js";
 import { getTransportConfig } from "./config/transport.js";
-import { createTaskSchema, deleteTaskSchema, getStreamsSchema, getTasksBacklogSchema, getTasksByDaySchema, getUserSchema, updateTaskCompleteSchema, updateTaskSnoozeDateSchema } from "./schemas.js";
+import { createTaskSchema, deleteTaskSchema, getArchivedTasksSchema, getStreamsSchema, getTasksBacklogSchema, getTasksByDaySchema, getUserSchema, updateTaskCompleteSchema, updateTaskSnoozeDateSchema } from "./schemas.js";
 import { getSunsamaClient } from "./utils/client-resolver.js";
 import { filterTasksByCompletion } from "./utils/task-filters.js";
 import { trimTasksForResponse } from "./utils/task-trimmer.js";
@@ -16,14 +16,14 @@ if (transportConfig.transportType === "stdio") {
 }
 const server = new FastMCP({
     name: "Sunsama API Server",
-    version: "0.4.0",
+    version: "0.5.2",
     instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 
 Available tools:
 - Authentication: login, logout, check authentication status
 - User operations: get current user information
-- Task operations: get tasks by day, get backlog tasks
+- Task operations: get tasks by day, get backlog tasks, get archived tasks
 - Stream operations: get streams/channels for the user's group
 
 Authentication is required for all operations. You can either:
@@ -149,6 +149,67 @@ server.addTool({
         }
     }
 });
+server.addTool({
+    name: "get-archived-tasks",
+    description: "Get archived tasks with optional pagination",
+    parameters: getArchivedTasksSchema,
+    execute: async (args, { session, log }) => {
+        try {
+            // Extract and set defaults for parameters
+            const offset = args.offset || 0;
+            const requestedLimit = args.limit || 100;
+            // Fetch limit + 1 to determine if there are more results
+            const fetchLimit = requestedLimit + 1;
+            log.info("Getting archived tasks", {
+                offset,
+                requestedLimit,
+                fetchLimit
+            });
+            // Get the appropriate client based on transport type
+            const sunsamaClient = getSunsamaClient(session);
+            // Get archived tasks (fetch limit + 1 to check for more)
+            const allTasks = await sunsamaClient.getArchivedTasks(offset, fetchLimit);
+            // Determine if there are more results and slice to requested limit
+            const hasMore = allTasks.length > requestedLimit;
+            const tasks = hasMore ? allTasks.slice(0, requestedLimit) : allTasks;
+            // Trim tasks to reduce response size while preserving essential data
+            const trimmedTasks = trimTasksForResponse(tasks);
+            // Create pagination metadata
+            const paginationInfo = {
+                offset,
+                limit: requestedLimit,
+                count: tasks.length,
+                hasMore,
+                nextOffset: hasMore ? offset + requestedLimit : null
+            };
+            log.info("Successfully retrieved archived tasks", {
+                totalReturned: tasks.length,
+                hasMore,
+                offset,
+                requestedLimit
+            });
+            // Create response with pagination metadata header and TSV data
+            const responseText = `# Pagination: offset=${paginationInfo.offset}, limit=${paginationInfo.limit}, count=${paginationInfo.count}, hasMore=${paginationInfo.hasMore}, nextOffset=${paginationInfo.nextOffset || 'null'}
+${toTsv(trimmedTasks)}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            log.error("Failed to get archived tasks", {
+                offset: args.offset,
+                limit: args.limit,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            throw new Error(`Failed to get archived tasks: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+});
 // Task Mutation Operations
 server.addTool({
     name: "create-task",
@@ -397,15 +458,32 @@ server.addResource({
             text: `# Sunsama MCP Server Documentation
 
 ## Overview
-This MCP server provides access to the Sunsama API for task and project management.
-Authentication is handled server-side using environment variables.
+This MCP server provides comprehensive access to the Sunsama API for task and project management.
+Supports dual transport modes with different authentication strategies.
+
+## Transport Modes
+
+### Stdio Transport (Default)
+- Single global authentication using environment variables
+- Session maintained for entire server lifetime
+- Best for single-user local development
+
+### HTTP Stream Transport  
+- Per-request authentication via HTTP Basic Auth
+- Session-isolated client instances
+- Supports multiple concurrent users
 
 ## Authentication
-The server authenticates to Sunsama using environment variables:
+
+### Stdio Transport
+Uses environment variables (authenticated once at startup):
 - \`SUNSAMA_EMAIL\`: Your Sunsama account email
 - \`SUNSAMA_PASSWORD\`: Your Sunsama account password
 
-Authentication happens automatically on server startup. No client-side authentication is required.
+### HTTP Stream Transport
+Uses HTTP Basic Auth headers (per-request authentication):
+- \`Authorization: Basic <base64(email:password)>\`
+- Credentials provided in each HTTP request
 
 ## Available Tools
 
@@ -414,93 +492,85 @@ Authentication happens automatically on server startup. No client-side authentic
   - Parameters: none
   - Returns: User object with profile, timezone, and primary group details
 
-### Task Operations
+### Task Management
 - **get-tasks-by-day**: Get tasks for a specific day with optional filtering
   - Parameters: 
     - \`day\` (required): Date in YYYY-MM-DD format
     - \`timezone\` (optional): Timezone string (e.g., "America/New_York")
-    - \`completionFilter\` (optional): Filter by completion status
-      - \`"all"\` (default): Return all tasks
-      - \`"incomplete"\`: Return only incomplete tasks
-      - \`"completed"\`: Return only completed tasks
-  - Returns: Array of filtered Task objects for the specified day
+    - \`completionFilter\` (optional): Filter by completion status ("all", "incomplete", "completed")
+  - Returns: TSV of filtered Task objects for the specified day
 
 - **get-tasks-backlog**: Get tasks from the backlog
   - Parameters: none  
-  - Returns: Array of Task objects from the backlog
+  - Returns: TSV of Task objects from the backlog
 
-### Stream Operations
-- **get-streams**: Get streams for the user's group
-  - Parameters: none
-  - Returns: Array of Stream objects
-  - Note: Streams are called "channels" in the Sunsama UI. If a user requests channels, use this tool.
+- **get-archived-tasks**: Get archived tasks with optional pagination
+  - Parameters:
+    - \`offset\` (optional): Pagination offset (defaults to 0)
+    - \`limit\` (optional): Maximum number of tasks to return (defaults to 100, max: 1000)
+  - Returns: TSV of trimmed archived Task objects with pagination metadata header
+  - Pagination: Uses limit+1 pattern to determine if more results are available
 
-## Data Types
+- **create-task**: Create a new task with optional properties
+  - Parameters:
+    - \`text\` (required): Task title/description
+    - \`notes\` (optional): Additional task notes
+    - \`streamIds\` (optional): Array of stream IDs to associate with task
+    - \`timeEstimate\` (optional): Time estimate in minutes
+    - \`dueDate\` (optional): Due date string (ISO format)
+    - \`snoozeUntil\` (optional): Snooze until date string (ISO format)
+    - \`private\` (optional): Whether the task is private
+    - \`taskId\` (optional): Custom task ID
+  - Returns: JSON with task creation result
 
-### User Object
-\`\`\`typescript
-{
-  _id: string;
-  email: string;
-  profile: {
-    _id: string;
-    email: string;
-    firstName: string;
-    lastName: string;
-    timezone: string;
-    avatarUrl?: string;
-  };
-  primaryGroup?: {
-    groupId: string;
-    name: string;
-    role?: string;
-  };
-}
-\`\`\`
+- **update-task-complete**: Mark a task as complete
+  - Parameters:
+    - \`taskId\` (required): The ID of the task to mark as complete
+    - \`completeOn\` (optional): Completion timestamp (ISO format)
+    - \`limitResponsePayload\` (optional): Whether to limit response size
+  - Returns: JSON with completion result
 
-### Task Object
-\`\`\`typescript
-{
-  _id: string;
-  title: string;
-  description?: string;
-  status: string;
-  createdAt: string;
-  updatedAt: string;
-  scheduledDate?: string;
-  completedAt?: string;
-  streamId?: string;
-  userId: string;
-  groupId: string;
-}
-\`\`\`
+- **delete-task**: Delete a task permanently
+  - Parameters:
+    - \`taskId\` (required): The ID of the task to delete
+    - \`limitResponsePayload\` (optional): Whether to limit response size
+    - \`wasTaskMerged\` (optional): Whether the task was merged before deletion
+  - Returns: JSON with deletion result
 
-### Stream Object
-Note: Streams are called "channels" in the Sunsama UI.
-\`\`\`typescript
-{
-  _id: string;
-  name: string;
-  color?: string;
-  groupId: string;
-  isActive: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-\`\`\`
+- **update-task-snooze-date**: Reschedule tasks or move to backlog
+  - Parameters:
+    - \`taskId\` (required): The ID of the task to reschedule
+    - \`newDay\` (required): Target date in YYYY-MM-DD format, or null for backlog
+    - \`timezone\` (optional): Timezone string
+    - \`limitResponsePayload\` (optional): Whether to limit response size
+  - Returns: JSON with update result
 
-## Error Handling
-- All operations require valid Sunsama authentication
-- Invalid dates will return validation errors
-- Network errors are handled gracefully with descriptive messages
-- Server maintains session state across tool calls
+### Stream Operations
+- **get-streams**: Get streams for the user's group
+  - Parameters: none
+  - Returns: TSV of Stream objects
+  - Note: Streams are called "channels" in the Sunsama UI
+
+## Response Optimization
+- **Task Filtering**: Applied before processing for efficiency
+- **Task Trimming**: Removes non-essential fields, reducing payload by 60-80%
+- **TSV Format**: Used for arrays to optimize data processing
 
 ## Environment Setup
-Required environment variables:
-- \`API_KEY\`: MCP server authentication key
+
+### Required (Stdio Transport)
 - \`SUNSAMA_EMAIL\`: Sunsama account email
 - \`SUNSAMA_PASSWORD\`: Sunsama account password
-- \`PORT\`: Server port (default: 3000)
+
+### Optional Configuration
+- \`TRANSPORT_TYPE\`: "stdio" (default) | "httpStream" 
+- \`PORT\`: Server port for HTTP transport (default: 3002)
+
+## Error Handling
+- Comprehensive parameter validation using Zod schemas
+- Graceful handling of network errors with descriptive messages
+- Session-specific error isolation in HTTP transport mode
+- Proper authentication error responses
       `.trim()
         };
     }

package/dist/schemas.d.ts

@@ -17,6 +17,16 @@ export declare const getTasksByDaySchema: z.ZodObject<{
     completionFilter?: "all" | "incomplete" | "completed" | undefined;
 }>;
 export declare const getTasksBacklogSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getArchivedTasksSchema: z.ZodObject<{
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
 /**
  * User Operation Schemas
  */
@@ -84,7 +94,7 @@ export declare const deleteTaskSchema: z.ZodObject<{
 }>;
 export declare const updateTaskSnoozeDateSchema: z.ZodObject<{
     taskId: z.ZodString;
-    newDay: z.ZodNullable<z.ZodString>;
+    newDay: z.ZodUnion<[z.ZodString, z.ZodNull]>;
     timezone: z.ZodOptional<z.ZodString>;
     limitResponsePayload: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -523,6 +533,7 @@ export declare const errorResponseSchema: z.ZodObject<{
 export type CompletionFilter = z.infer<typeof completionFilterSchema>;
 export type GetTasksByDayInput = z.infer<typeof getTasksByDaySchema>;
 export type GetTasksBacklogInput = z.infer<typeof getTasksBacklogSchema>;
+export type GetArchivedTasksInput = z.infer<typeof getArchivedTasksSchema>;
 export type GetUserInput = z.infer<typeof getUserSchema>;
 export type GetStreamsInput = z.infer<typeof getStreamsSchema>;
 export type CreateTaskInput = z.infer<typeof createTaskSchema>;

package/dist/schemas.d.ts.map

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

package/dist/schemas.js

@@ -12,6 +12,11 @@ export const getTasksByDaySchema = z.object({
 });
 // Get tasks backlog parameters (no parameters needed)
 export const getTasksBacklogSchema = z.object({});
+// Get archived tasks parameters
+export const getArchivedTasksSchema = z.object({
+    offset: z.number().int().min(0).optional().describe("Pagination offset (defaults to 0)"),
+    limit: z.number().int().min(1).max(1000).optional().describe("Maximum number of tasks to return (defaults to 100)"),
+});
 /**
  * User Operation Schemas
  */
@@ -51,7 +56,10 @@ export const deleteTaskSchema = z.object({
 // Update task snooze date parameters
 export const updateTaskSnoozeDateSchema = z.object({
     taskId: z.string().min(1, "Task ID is required").describe("The ID of the task to reschedule"),
-    newDay: z.string().date("Must be a valid date in YYYY-MM-DD format").nullable().describe("Target date in YYYY-MM-DD format, or null to move to backlog"),
+    newDay: z.union([
+        z.string().date("Must be a valid date in YYYY-MM-DD format"),
+        z.null()
+    ]).describe("Target date in YYYY-MM-DD format, or null to move to backlog"),
     timezone: z.string().optional().describe("Timezone string (e.g., 'America/New_York'). If not provided, uses user's default timezone"),
     limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size"),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-sunsama",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "MCP server for Sunsama API integration",
   "type": "module",
   "private": false,
@@ -19,7 +19,8 @@
     "inspect": "npx @modelcontextprotocol/inspector --config ./mcp-inspector.json --server sunsama",
     "changeset": "changeset",
     "version": "changeset version",
-    "release": "bun run build && changeset publish"
+    "release": "bun run build && changeset publish",
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@types/papaparse": "^5.3.16",

package/src/main.ts

@@ -31,7 +31,7 @@ if (transportConfig.transportType === "stdio") {
 
 const server = new FastMCP({
   name: "Sunsama API Server",
-  version: "0.5.0",
+  version: "0.5.2",
   instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/src/schemas.ts

@@ -70,7 +70,10 @@ export const deleteTaskSchema = z.object({
 // Update task snooze date parameters
 export const updateTaskSnoozeDateSchema = z.object({
   taskId: z.string().min(1, "Task ID is required").describe("The ID of the task to reschedule"),
-  newDay: z.string().date("Must be a valid date in YYYY-MM-DD format").nullable().describe("Target date in YYYY-MM-DD format, or null to move to backlog"),
+  newDay: z.union([
+    z.string().date("Must be a valid date in YYYY-MM-DD format"),
+    z.null()
+  ]).describe("Target date in YYYY-MM-DD format, or null to move to backlog"),
   timezone: z.string().optional().describe("Timezone string (e.g., 'America/New_York'). If not provided, uses user's default timezone"),
   limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size"),
 });

package/TODO-0_5_0.md

@@ -1,108 +0,0 @@
-# Sunsama MCP Server - Implementation Status & Future Plans
-
-## Current Status (⚠️ Update Required)
-
-**Package Version**: sunsama-api v0.6.0 (updated 2025-06-20)
-
-The MCP server currently implements **61.5% coverage** (8/13 methods) of available methods in the sunsama-api package.
-
-**NEW METHODS AVAILABLE**: 5 additional methods are now available in sunsama-api v0.6.0 that need MCP tool implementation.
-
-### Implemented Tools
-
-#### User Operations
-- ✅ `get-user` → `SunsamaClient.getUser()`
-  - Returns user profile, timezone, and group information
-
-#### Task Operations
-- ✅ `get-tasks-by-day` → `SunsamaClient.getTasksByDay(day, timezone?)`
-  - Supports completion filtering (`all`, `incomplete`, `completed`)
-  - Includes task trimming for response optimization
-- ✅ `get-tasks-backlog` → `SunsamaClient.getTasksBacklog()`
-  - Returns all backlog tasks with trimming optimization
-- ✅ `create-task` → `SunsamaClient.createTask(text, options?)`
-  - Full parameter support: notes, timeEstimate, dueDate, streamIds, etc.
-- ✅ `update-task-complete` → `SunsamaClient.updateTaskComplete(taskId, completeOn?, limitResponsePayload?)`
-  - Mark tasks as complete with optional timestamp
-- ✅ `delete-task` → `SunsamaClient.deleteTask(taskId, limitResponsePayload?, wasTaskMerged?)`
-  - Permanent task deletion
-- ✅ `update-task-snooze-date` → `SunsamaClient.updateTaskSnoozeDate(taskId, newDay, options?)`
-  - Reschedule tasks or move to backlog
-
-#### Stream Operations
-- ✅ `get-streams` → `SunsamaClient.getStreamsByGroupId()`
-  - Returns all available streams (channels) for the user's group
-
-## Future Enhancements
-
-### 1. Archived Tasks (Priority: Medium)
-**Status**: Research needed - API exists but not in sunsama-api package
-
-**Description**: Implement support for retrieving archived tasks
-- **API Endpoint**: `/get-archived-tasks` (confirmed in dev/user-stories/)
-- **Parameters**: `userId`, `groupId`, `offset`, `limit`, optional filters
-- **Returns**: Archived tasks with `archivedAt` timestamps
-
-**Implementation Steps**:
-1. **Upstream Work**: Add `getArchivedTasks()` method to sunsama-api package
-2. **MCP Tool**: Implement `get-archived-tasks` tool with:
-   - Pagination support (`offset`, `limit`)
-   - Date range filtering (`dateFrom`, `dateTo`)
-   - Stream filtering
-   - Response trimming optimization
-
-### 2. Enhanced Task Management (Priority: Low)
-**Potential Extensions**:
-- Task bulk operations (bulk delete, bulk complete)
-- Task search/filtering by content
-- Task time tracking integration
-- Task dependency management
-
-### 3. Advanced Stream Operations (Priority: Low)
-**Potential Extensions**:
-- Stream creation/modification (if API supports)
-- Stream-specific task queries
-- Stream statistics/analytics
-
-### 4. Performance Optimizations (Priority: Low)
-**Current Optimizations**:
-- ✅ Task filtering before processing
-- ✅ Response payload trimming (60-80% reduction)
-- ✅ Dual transport support (stdio/HTTP)
-
-**Future Optimizations**:
-- Response caching for frequently accessed data
-- Batch operations for multiple task updates
-- Streaming responses for large datasets
-
-## Development Notes
-
-### Architecture Strengths
-- Complete dual transport support (stdio + HTTP stream)
-- Robust authentication handling per transport type
-- Comprehensive error handling and validation
-- Response optimization strategies
-- Type-safe parameter validation with Zod schemas
-
-### Maintenance Tasks
-- ✅ Version synchronization (package.json ↔ src/main.ts)
-- Monitor sunsama-api updates for new methods
-- Update dependencies regularly
-- Maintain test coverage
-
-### Contributing Guidelines
-- Follow existing patterns in `src/main.ts`
-- Use Zod schemas for parameter validation
-- Implement response trimming for large datasets
-- Support both transport modes
-- Add comprehensive tool descriptions
-
-## Conclusion
-
-The current implementation provides complete coverage of the sunsama-api package with a robust, well-architected foundation. Future enhancements should focus on:
-
-1. **Upstream API Development**: Contributing archived tasks functionality to sunsama-api
-2. **Advanced Features**: Building on the solid foundation for enhanced productivity workflows
-3. **Performance**: Continuous optimization as usage scales
-
-The codebase is well-positioned for extension and maintenance with clear patterns and comprehensive documentation.