@open-sunsama/mcp 1.0.0

package/build/tools/time-blocks.js

@@ -0,0 +1,456 @@
+/**
+ * MCP Tools for Time Block Management
+ *
+ * Time blocks represent scheduled chunks of focused work time on your calendar.
+ * They can optionally be linked to tasks to track what you're working on.
+ */
+import { z } from "zod";
+/**
+ * Format a time block for display with human-readable information
+ */
+function formatTimeBlock(block) {
+    const lines = [
+        `Time Block: ${block.title}`,
+        `ID: ${block.id}`,
+        `Date: ${block.date}`,
+        `Time: ${block.startTime} - ${block.endTime} (${block.durationMins} mins)`,
+    ];
+    if (block.description) {
+        lines.push(`Description: ${block.description}`);
+    }
+    if (block.taskId) {
+        lines.push(`Linked Task ID: ${block.taskId}`);
+        if (block.task) {
+            lines.push(`Linked Task: ${block.task.title}`);
+        }
+    }
+    if (block.color) {
+        lines.push(`Color: ${block.color}`);
+    }
+    lines.push(`Created: ${block.createdAt}`);
+    lines.push(`Updated: ${block.updatedAt}`);
+    return lines.join("\n");
+}
+/**
+ * Format multiple time blocks as a schedule view
+ */
+function formatSchedule(blocks, date) {
+    if (blocks.length === 0) {
+        return `No time blocks scheduled for ${date}`;
+    }
+    // Sort by start time
+    const sorted = [...blocks].sort((a, b) => a.startTime.localeCompare(b.startTime));
+    const lines = [`Schedule for ${date}:`, "─".repeat(40)];
+    for (const block of sorted) {
+        const taskInfo = block.taskId
+            ? ` [Task: ${block.task?.title || block.taskId}]`
+            : "";
+        lines.push(`${block.startTime} - ${block.endTime}: ${block.title}${taskInfo}`);
+        if (block.description) {
+            lines.push(`  └─ ${block.description}`);
+        }
+    }
+    // Calculate total scheduled time
+    const totalMins = sorted.reduce((sum, b) => sum + b.durationMins, 0);
+    const hours = Math.floor(totalMins / 60);
+    const mins = totalMins % 60;
+    lines.push("─".repeat(40));
+    lines.push(`Total: ${blocks.length} blocks, ${hours}h ${mins}m scheduled`);
+    return lines.join("\n");
+}
+/**
+ * Creates a success response for MCP tools
+ */
+function successResponse(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Creates an error response for MCP tools
+ */
+function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+/**
+ * Register all time block MCP tools
+ */
+export function registerTimeBlockTools(server, apiClient) {
+    // List time blocks with optional filters
+    server.tool("list_time_blocks", `List time blocks from your calendar with optional filters.
+
+Use this tool to:
+- View all time blocks for a specific date (use 'date' parameter)
+- View time blocks across a date range (use 'from' and 'to' parameters)
+- Find all time blocks linked to a specific task (use 'taskId' parameter)
+- Browse through paginated results (use 'page' and 'limit' parameters)
+
+Time blocks represent scheduled chunks of focused work time. They can be 
+linked to tasks to track what work is being done during that time.
+
+Returns a list of time blocks with their details including title, date, 
+start/end times, duration, description, color, and any linked task info.`, {
+        date: z
+            .string()
+            .optional()
+            .describe("Filter by specific date in YYYY-MM-DD format (e.g., '2024-01-15'). Cannot be used with from/to."),
+        from: z
+            .string()
+            .optional()
+            .describe("Start of date range in YYYY-MM-DD format. Must be used with 'to' parameter."),
+        to: z
+            .string()
+            .optional()
+            .describe("End of date range in YYYY-MM-DD format. Must be used with 'from' parameter."),
+        taskId: z
+            .string()
+            .optional()
+            .describe("Filter to only show time blocks linked to this specific task ID"),
+        page: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Page number for pagination (default: 1)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(100)
+            .optional()
+            .describe("Number of results per page (default: 50, max: 100)"),
+    }, async (input) => {
+        try {
+            const response = await apiClient.listTimeBlocks({
+                date: input.date,
+                from: input.from,
+                to: input.to,
+                taskId: input.taskId,
+                page: input.page,
+                limit: input.limit,
+            });
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to list time blocks");
+            }
+            const blocks = response.data || [];
+            if (blocks.length === 0) {
+                return successResponse("No time blocks found matching your criteria.");
+            }
+            let result = blocks.map((b) => formatTimeBlock(b)).join("\n\n---\n\n");
+            if (response.meta) {
+                result += `\n\n---\nPage ${response.meta.page} of ${response.meta.totalPages} (${response.meta.total} total blocks)`;
+            }
+            return successResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Get a specific time block by ID
+    server.tool("get_time_block", `Get detailed information about a specific time block by its ID.
+
+Use this tool when you need to:
+- View the full details of a time block
+- Check if a time block exists
+- See what task is linked to a time block
+- Get the exact timing and duration of a scheduled block
+
+Returns complete time block information including title, date, start/end times,
+duration in minutes, description, color, and linked task details if any.`, {
+        id: z.string().describe("The unique ID of the time block to retrieve"),
+    }, async (input) => {
+        try {
+            const response = await apiClient.getTimeBlock(input.id);
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Time block not found");
+            }
+            return successResponse(formatTimeBlock(response.data));
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Create a new time block
+    server.tool("create_time_block", `Create a new time block to schedule focused work time on your calendar.
+
+Use this tool to:
+- Schedule a block of time for focused work
+- Plan your day by creating time-boxed sessions
+- Reserve time for specific activities or tasks
+- Create recurring work sessions (one at a time)
+
+Time blocks help you:
+- Protect time for deep work
+- Visualize your day's schedule
+- Track how you spend your time
+- Link work sessions to specific tasks
+
+The time block will appear on your calendar for the specified date and time.
+You can optionally link it to an existing task to track what you'll work on.`, {
+        title: z
+            .string()
+            .min(1)
+            .max(200)
+            .describe("Title of the time block (e.g., 'Deep work session', 'Team standup', 'Code review')"),
+        date: z
+            .string()
+            .describe("Date for the time block in YYYY-MM-DD format (e.g., '2024-01-15')"),
+        startTime: z
+            .string()
+            .describe("Start time in 24-hour HH:MM format (e.g., '09:00', '14:30')"),
+        endTime: z
+            .string()
+            .describe("End time in 24-hour HH:MM format (e.g., '11:00', '16:00'). Must be after startTime."),
+        taskId: z
+            .string()
+            .optional()
+            .describe("Optional: ID of a task to link to this time block. Links the scheduled time to specific work."),
+        description: z
+            .string()
+            .max(1000)
+            .optional()
+            .describe("Optional: Additional notes or context for this time block"),
+        color: z
+            .string()
+            .optional()
+            .describe("Optional: Hex color code for visual distinction (e.g., '#3B82F6' for blue, '#10B981' for green)"),
+    }, async (input) => {
+        try {
+            // Validate time format
+            const timeRegex = /^([01]\d|2[0-3]):([0-5]\d)$/;
+            if (!timeRegex.test(input.startTime)) {
+                return errorResponse(`Invalid start time format '${input.startTime}'. Use HH:MM 24-hour format (e.g., '09:00', '14:30')`);
+            }
+            if (!timeRegex.test(input.endTime)) {
+                return errorResponse(`Invalid end time format '${input.endTime}'. Use HH:MM 24-hour format (e.g., '11:00', '16:00')`);
+            }
+            // Validate date format
+            const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+            if (!dateRegex.test(input.date)) {
+                return errorResponse(`Invalid date format '${input.date}'. Use YYYY-MM-DD format (e.g., '2024-01-15')`);
+            }
+            // Validate end time is after start time
+            if (input.endTime <= input.startTime) {
+                return errorResponse(`End time (${input.endTime}) must be after start time (${input.startTime})`);
+            }
+            // Validate color format if provided
+            if (input.color && !/^#[0-9A-Fa-f]{6}$/.test(input.color)) {
+                return errorResponse(`Invalid color format '${input.color}'. Use 6-digit hex code (e.g., '#3B82F6')`);
+            }
+            const response = await apiClient.createTimeBlock({
+                title: input.title,
+                date: input.date,
+                startTime: input.startTime,
+                endTime: input.endTime,
+                taskId: input.taskId,
+                description: input.description,
+                color: input.color,
+            });
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to create time block");
+            }
+            return successResponse(`Time block created successfully!\n\n${formatTimeBlock(response.data)}`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Update an existing time block
+    server.tool("update_time_block", `Update an existing time block's details.
+
+Use this tool to:
+- Reschedule a time block to a different time or date
+- Change the title or description
+- Update the color for visual organization
+- Link or unlink a task (use link_task_to_time_block for just that)
+
+Only provide the fields you want to change. Omitted fields will remain unchanged.
+To clear optional fields (description, color, taskId), pass null explicitly.`, {
+        id: z.string().describe("The unique ID of the time block to update"),
+        title: z
+            .string()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("New title for the time block"),
+        date: z
+            .string()
+            .optional()
+            .describe("New date in YYYY-MM-DD format (e.g., '2024-01-15')"),
+        startTime: z
+            .string()
+            .optional()
+            .describe("New start time in HH:MM 24-hour format (e.g., '09:00')"),
+        endTime: z
+            .string()
+            .optional()
+            .describe("New end time in HH:MM 24-hour format (e.g., '11:00')"),
+        taskId: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("Task ID to link, or null to unlink. Omit to keep current link."),
+        description: z
+            .string()
+            .max(1000)
+            .nullable()
+            .optional()
+            .describe("New description, or null to clear"),
+        color: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("New hex color (e.g., '#3B82F6'), or null to clear"),
+    }, async (input) => {
+        try {
+            const { id, ...updates } = input;
+            // Validate time formats if provided
+            const timeRegex = /^([01]\d|2[0-3]):([0-5]\d)$/;
+            if (updates.startTime && !timeRegex.test(updates.startTime)) {
+                return errorResponse(`Invalid start time format '${updates.startTime}'. Use HH:MM 24-hour format`);
+            }
+            if (updates.endTime && !timeRegex.test(updates.endTime)) {
+                return errorResponse(`Invalid end time format '${updates.endTime}'. Use HH:MM 24-hour format`);
+            }
+            // Validate date format if provided
+            if (updates.date && !/^\d{4}-\d{2}-\d{2}$/.test(updates.date)) {
+                return errorResponse(`Invalid date format '${updates.date}'. Use YYYY-MM-DD format`);
+            }
+            // Validate color format if provided
+            if (updates.color !== null &&
+                updates.color !== undefined &&
+                !/^#[0-9A-Fa-f]{6}$/.test(updates.color)) {
+                return errorResponse(`Invalid color format '${updates.color}'. Use 6-digit hex code (e.g., '#3B82F6')`);
+            }
+            // Build update payload, only including defined fields
+            const updateData = {};
+            if (updates.title !== undefined)
+                updateData.title = updates.title;
+            if (updates.date !== undefined)
+                updateData.date = updates.date;
+            if (updates.startTime !== undefined)
+                updateData.startTime = updates.startTime;
+            if (updates.endTime !== undefined)
+                updateData.endTime = updates.endTime;
+            if (updates.taskId !== undefined)
+                updateData.taskId = updates.taskId;
+            if (updates.description !== undefined)
+                updateData.description = updates.description;
+            if (updates.color !== undefined)
+                updateData.color = updates.color;
+            if (Object.keys(updateData).length === 0) {
+                return errorResponse("No updates provided. Please provide at least one field to update.");
+            }
+            const response = await apiClient.updateTimeBlock(id, updateData);
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to update time block");
+            }
+            return successResponse(`Time block updated successfully!\n\n${formatTimeBlock(response.data)}`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Delete a time block
+    server.tool("delete_time_block", `Delete a time block from your calendar.
+
+Use this tool to:
+- Remove a scheduled time block that's no longer needed
+- Clear a time slot that was cancelled
+- Delete mistakenly created time blocks
+
+This action is permanent. The time block will be removed from your schedule.
+Any linked task will NOT be deleted, only the link will be removed.`, {
+        id: z.string().describe("The unique ID of the time block to delete"),
+    }, async (input) => {
+        try {
+            const response = await apiClient.deleteTimeBlock(input.id);
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to delete time block");
+            }
+            return successResponse(`Time block deleted successfully. (ID: ${input.id})`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Link or unlink a task to a time block
+    server.tool("link_task_to_time_block", `Link a task to a time block, or unlink a task from a time block.
+
+Use this tool to:
+- Connect a scheduled time block to a specific task you'll work on
+- Track which task you're dedicating time to
+- Unlink a task if the time block is for something else
+
+When a task is linked to a time block:
+- The calendar shows what you'll be working on
+- You can see which tasks have dedicated time slots
+- Time tracking becomes more meaningful
+
+To unlink a task, pass null as the taskId.`, {
+        timeBlockId: z
+            .string()
+            .describe("The ID of the time block to link/unlink"),
+        taskId: z
+            .string()
+            .nullable()
+            .describe("The task ID to link to this time block, or null to unlink the current task"),
+    }, async (input) => {
+        try {
+            const response = await apiClient.updateTimeBlock(input.timeBlockId, {
+                taskId: input.taskId,
+            });
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to update time block");
+            }
+            const action = input.taskId ? "linked" : "unlinked";
+            return successResponse(`Task ${action} successfully!\n\n${formatTimeBlock(response.data)}`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Get schedule for a specific day (convenience tool)
+    server.tool("get_schedule_for_day", `Get all time blocks for a specific day, formatted as a schedule view.
+
+This is a convenience tool that:
+- Fetches all time blocks for the given date
+- Sorts them chronologically
+- Formats them as a readable daily schedule
+- Shows total scheduled time
+
+Use this tool to:
+- See your schedule for today or any other day
+- Review how your day is organized
+- Check for gaps in your schedule
+- Get an overview before planning
+
+The schedule shows times, titles, and linked tasks in an easy-to-read format.`, {
+        date: z
+            .string()
+            .describe("The date to get the schedule for in YYYY-MM-DD format (e.g., '2024-01-15')"),
+    }, async (input) => {
+        try {
+            // Validate date format
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(input.date)) {
+                return errorResponse(`Invalid date format '${input.date}'. Use YYYY-MM-DD format (e.g., '2024-01-15')`);
+            }
+            const response = await apiClient.listTimeBlocks({
+                date: input.date,
+                limit: 100, // Get all blocks for the day
+            });
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to get schedule");
+            }
+            const blocks = response.data || [];
+            return successResponse(formatSchedule(blocks, input.date));
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+}
+//# sourceMappingURL=time-blocks.js.map

package/build/tools/time-blocks.js.map

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

package/build/tools/user.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP tools for user profile management
+ * Provides tools for viewing and updating user profile information
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../lib/api-client.js";
+/**
+ * Register all user-related tools with the MCP server
+ */
+export declare function registerUserTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=user.d.ts.map

package/build/tools/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AA6C7E;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,SAAS,GACnB,IAAI,CAiJN"}

package/build/tools/user.js

@@ -0,0 +1,147 @@
+/**
+ * MCP tools for user profile management
+ * Provides tools for viewing and updating user profile information
+ */
+import { z } from "zod";
+/**
+ * Format user profile for display
+ */
+function formatUserProfile(user) {
+    const lines = [
+        `Name: ${user.name || "(not set)"}`,
+        `Email: ${user.email}`,
+        `Timezone: ${user.timezone}`,
+        `Avatar URL: ${user.avatarUrl || "(not set)"}`,
+        `Account created: ${new Date(user.createdAt).toLocaleDateString()}`,
+        `Last updated: ${new Date(user.updatedAt).toLocaleDateString()}`,
+    ];
+    if (user.preferences) {
+        lines.push("");
+        lines.push("Preferences:");
+        lines.push(`  Theme mode: ${user.preferences.themeMode}`);
+        lines.push(`  Color theme: ${user.preferences.colorTheme}`);
+        lines.push(`  Font family: ${user.preferences.fontFamily}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Creates a success response for MCP tools
+ */
+function successResponse(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Creates an error response for MCP tools
+ */
+function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+/**
+ * Register all user-related tools with the MCP server
+ */
+export function registerUserTools(server, apiClient) {
+    // Get current user profile
+    server.tool("get_user_profile", "Get the current authenticated user's profile information. Returns the user's name, email, timezone, avatar URL, and preferences (theme mode, color theme, font family). This is useful for personalizing interactions or understanding the user's settings.", {}, async () => {
+        try {
+            const response = await apiClient.getMe();
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to fetch user profile");
+            }
+            const user = response.data;
+            const formattedProfile = formatUserProfile(user);
+            return successResponse(`User Profile:\n\n${formattedProfile}\n\nUser ID: ${user.id}`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+    // Update user profile
+    server.tool("update_user_profile", "Update the current user's profile information. You can update the user's display name, timezone, avatar URL, and preferences (theme mode, color theme, font family). At least one field must be provided. The timezone should be a valid IANA timezone identifier (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo').", {
+        name: z
+            .string()
+            .optional()
+            .describe("The user's display name. This is shown in the UI and can be any string"),
+        timezone: z
+            .string()
+            .optional()
+            .describe("The user's timezone as an IANA timezone identifier (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo', 'UTC'). Used for scheduling and displaying times"),
+        avatarUrl: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("URL to the user's avatar image. Set to null to remove the avatar"),
+        themeMode: z
+            .enum(["light", "dark", "system"])
+            .optional()
+            .describe("UI theme mode preference. 'light' for light theme, 'dark' for dark theme, 'system' to follow system settings"),
+        colorTheme: z
+            .string()
+            .optional()
+            .describe("Color theme/accent color for the UI (e.g., 'blue', 'green', 'purple')"),
+        fontFamily: z
+            .string()
+            .optional()
+            .describe("Font family preference for the UI (e.g., 'Inter', 'SF Pro', 'Roboto')"),
+    }, async (input) => {
+        try {
+            // Build update data
+            const updateData = {};
+            // Handle direct fields
+            if (input.name !== undefined) {
+                updateData.name = input.name;
+            }
+            if (input.timezone !== undefined) {
+                updateData.timezone = input.timezone;
+            }
+            if (input.avatarUrl !== undefined) {
+                updateData.avatarUrl = input.avatarUrl;
+            }
+            // Handle preferences
+            const preferences = {};
+            if (input.themeMode !== undefined) {
+                preferences.themeMode = input.themeMode;
+            }
+            if (input.colorTheme !== undefined) {
+                preferences.colorTheme = input.colorTheme;
+            }
+            if (input.fontFamily !== undefined) {
+                preferences.fontFamily = input.fontFamily;
+            }
+            if (Object.keys(preferences).length > 0) {
+                updateData.preferences = preferences;
+            }
+            // Check if at least one field is provided
+            if (Object.keys(updateData).length === 0) {
+                return errorResponse("At least one field must be provided to update the profile");
+            }
+            const response = await apiClient.updateMe(updateData);
+            if (!response.success) {
+                return errorResponse(response.error?.message || "Failed to update user profile");
+            }
+            const user = response.data;
+            const updatedFields = [];
+            if (input.name !== undefined)
+                updatedFields.push("name");
+            if (input.timezone !== undefined)
+                updatedFields.push("timezone");
+            if (input.avatarUrl !== undefined)
+                updatedFields.push("avatarUrl");
+            if (input.themeMode !== undefined)
+                updatedFields.push("themeMode");
+            if (input.colorTheme !== undefined)
+                updatedFields.push("colorTheme");
+            if (input.fontFamily !== undefined)
+                updatedFields.push("fontFamily");
+            return successResponse(`Successfully updated user profile (fields: ${updatedFields.join(", ")}):\n\n${formatUserProfile(user)}`);
+        }
+        catch (error) {
+            return errorResponse(error instanceof Error ? error.message : "Unknown error");
+        }
+    });
+}
+//# sourceMappingURL=user.js.map

package/build/tools/user.js.map

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