mcp-intervals 1.4.1 → 1.5.1

package/dist/cli/api.js

@@ -11,7 +11,7 @@ export async function validateToken(token) {
             const data = (await response.json());
             return {
                 valid: true,
-                workspace: data.me?.company || "Unknown workspace",
+                workspace: data.me?.[0]?.company || "Unknown workspace",
             };
         }
         if (response.status === 401) {

package/dist/client.js

@@ -27,7 +27,7 @@ export class IntervalsClient {
         const response = await fetch(url, fetchOptions);
         if (!response.ok) {
             const text = await response.text();
-            throw new Error(`Intervals API error ${response.status}: ${text}`);
+            throw new Error(`Intervals API error ${response.status}: ${text.slice(0, 500)}`);
         }
         return response.json();
     }
@@ -127,6 +127,9 @@ export class IntervalsClient {
         // First get the current user's person ID
         const me = await this.getMe();
         const personid = me.personid;
+        if (typeof personid !== "number") {
+            throw new Error("Could not determine current user's person ID from Intervals /me/ response.");
+        }
         const data = await this.request(`/time/`, {
             method: "POST",
             body: {
@@ -149,6 +152,6 @@ export class IntervalsClient {
     async getMe() {
         const data = await this.request(`/me/`);
         // Return the first user object with personid from the top-level response
-        return { ...data.me[0], personid: data.personid };
+        return { ...(data.me?.[0] ?? {}), personid: data.personid };
     }
 }

package/dist/index.js

@@ -13,6 +13,10 @@ async function startServer() {
     const { IntervalsClient } = await import("./client.js");
     const { registerTools } = await import("./tools.js");
     const { registerResources } = await import("./resources.js");
+    const { createRequire } = await import("node:module");
+    // Read version from package.json so it never drifts from the published one.
+    const require = createRequire(import.meta.url);
+    const { version } = require("../package.json");
     const API_TOKEN = process.env.INTERVALS_API_TOKEN;
     if (!API_TOKEN) {
         console.error("Error: INTERVALS_API_TOKEN environment variable is required.");
@@ -21,7 +25,7 @@ async function startServer() {
     const client = new IntervalsClient(API_TOKEN);
     const server = new McpServer({
         name: "mcp-intervals",
-        version: "1.0.0",
+        version,
     });
     registerTools(server, client);
     registerResources(server, client);

package/dist/tools.js

@@ -1,5 +1,10 @@
 import { z } from "zod";
+import { PDFParse } from "pdf-parse";
 import { parseTaskIdFromUrl, getMimeTypeFromFilename, isImageMimeType, } from "./utils.js";
+// Cap on inline-rendered downloads (images/PDFs). Base64 inflates payload
+// ~33% and the result is fed into the model context, so guard against
+// flooding memory/context with oversized attachments.
+const MAX_INLINE_DOWNLOAD_BYTES = 25 * 1024 * 1024; // 25 MB
 export function registerTools(server, client) {
     // --- get_task ---
     server.tool("get_task", "Retrieve full details of an Intervals task. Accepts a task URL (e.g. https://<subdomain>.intervalsonline.com/tasks/view/12345) or a numeric local task ID (the ID shown in the Intervals web UI).", {
@@ -241,7 +246,7 @@ export function registerTools(server, client) {
         };
     });
     // --- download_document ---
-    server.tool("download_document", "Download a document from Intervals. For images (png, jpg, gif, webp, bmp), returns the image inline so it can be viewed directly. For other file types, returns the document metadata.", {
+    server.tool("download_document", "Download a document from Intervals. For images (png, jpg, gif, webp, bmp), returns the image inline so it can be viewed directly. For PDFs, extracts and returns the text content. For other file types, returns the document metadata.", {
         documentId: z
             .number()
             .describe("The numeric document ID from Intervals"),
@@ -251,6 +256,17 @@ export function registerTools(server, client) {
         const docField = docData.document;
         let document;
         if (Array.isArray(docField)) {
+            if (docField.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No document found with ID ${documentId}.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             document = docField[0];
         }
         else if (docField && typeof docField === "object") {
@@ -261,10 +277,35 @@ export function registerTools(server, client) {
         }
         const filename = document.filename || document.title || "unknown";
         const title = document.title || filename;
+        // Reject oversized files before downloading them into memory.
+        const reportedSize = Number(document.filesize);
+        if (Number.isFinite(reportedSize) &&
+            reportedSize > MAX_INLINE_DOWNLOAD_BYTES) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Document "${title}" (${filename}) is ${(reportedSize / (1024 * 1024)).toFixed(2)} MB, exceeding the ${MAX_INLINE_DOWNLOAD_BYTES / (1024 * 1024)} MB inline limit. Download it directly from Intervals instead.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
         const imageMimeType = getMimeTypeFromFilename(filename);
         if (imageMimeType && isImageMimeType(imageMimeType)) {
             try {
                 const { buffer } = await client.downloadDocument(documentId);
+                if (buffer.byteLength > MAX_INLINE_DOWNLOAD_BYTES) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Document "${title}" (${filename}) is ${(buffer.byteLength / (1024 * 1024)).toFixed(2)} MB, exceeding the ${MAX_INLINE_DOWNLOAD_BYTES / (1024 * 1024)} MB inline limit. Download it directly from Intervals instead.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
                 const base64 = Buffer.from(buffer).toString("base64");
                 const sizeMB = buffer.byteLength / (1024 * 1024);
                 const content = [
@@ -301,7 +342,35 @@ export function registerTools(server, client) {
                 };
             }
         }
-        // Non-image file: return metadata only
+        // PDF: extract text content
+        if (filename.toLowerCase().endsWith(".pdf")) {
+            try {
+                const { buffer } = await client.downloadDocument(documentId);
+                const sizeMB = buffer.byteLength / (1024 * 1024);
+                const pdf = new PDFParse({ data: new Uint8Array(buffer) });
+                const textResult = await pdf.getText();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Document: ${title} (${filename}, ${sizeMB.toFixed(2)} MB, ${textResult.total} pages)\n\n${textResult.text}`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Document "${title}" (${filename}) is a PDF but text extraction failed: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Other file types: return metadata only
         return {
             content: [
                 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-intervals",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description": "MCP server for Intervals task management",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,7 @@
   "dependencies": {
     "@clack/prompts": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "pdf-parse": "^2.4.5",
     "picocolors": "^1.1.1",
     "zod": "^3.24.2"
   },