ms365-mcp-server 1.1.13 → 1.1.15

package/dist/index.js

@@ -10,7 +10,7 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import fs from 'fs/promises';
 import crypto from 'crypto';
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, ReadResourceRequestSchema, ListResourceTemplatesRequestSchema, GetPromptRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { logger } from './utils/api.js';
 import { MS365Operations } from './utils/ms365-operations.js';
 import { multiUserMS365Auth } from './utils/multi-user-auth.js';
@@ -67,23 +67,28 @@ function parseArgs() {
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.1.13"
+    version: "1.1.15"
 }, {
     capabilities: {
         resources: {
             read: true,
-            list: true
+            list: true,
+            templates: true
         },
         tools: {
             list: true,
             call: true
         },
         prompts: {
+            list: true,
+            get: true
+        },
+        resourceTemplates: {
             list: true
         }
     }
 });
-logger.log('Server started with version 1.1.13');
+logger.log('Server started with version 1.1.14');
 // Set up the resource listing request handler
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     logger.log('Received list resources request');
@@ -103,6 +108,20 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
     logger.log('Received list prompts request');
     return { prompts: [] };
 });
+/**
+ * Handler for getting a specific prompt.
+ */
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    logger.log('Received get prompt request: ' + JSON.stringify(request));
+    throw new Error("Prompt getting not implemented");
+});
+/**
+ * Handler for listing available resource templates.
+ */
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+    logger.log('Received list resource templates request');
+    return { resourceTemplates: [] };
+});
 /**
  * List available tools for interacting with Microsoft 365.
  */
@@ -119,19 +138,25 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "User ID for multi-user authentication (required if using multi-user mode)"
                     },
                     to: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of recipient email addresses"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "Recipient email address (string) or list of recipient email addresses (array)"
                     },
                     cc: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of CC recipient email addresses (optional)"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "CC recipient email address (string) or list of CC recipient email addresses (array) - optional"
                     },
                     bcc: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of BCC recipient email addresses (optional)"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "BCC recipient email address (string) or list of BCC recipient email addresses (array) - optional"
                     },
                     subject: {
                         type: "string",
@@ -180,8 +205,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "List of email attachments (optional)"
                     }
                 },
-                required: ["to", "subject"],
-                additionalProperties: false
+                required: ["to", "subject"]
             }
         },
         {
@@ -196,8 +220,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     },
                     action: {
                         type: "string",
-                        enum: ["read", "search", "list", "mark", "move", "delete", "search_to_me", "draft", "update_draft", "send_draft", "list_drafts", "reply_draft", "forward_draft"],
-                        description: "Action to perform: read (get email by ID), search (find emails), list (folder contents), mark (read/unread), move (to folder), delete (permanently), search_to_me (emails addressed to you), draft (create standalone draft - NOTE: Use reply_draft/forward_draft for threaded drafts), update_draft (modify existing draft), send_draft (send saved draft), list_drafts (list draft emails), reply_draft (create threaded reply draft that appears in conversation), forward_draft (create threaded forward draft that appears in conversation)"
+                        enum: ["read", "search", "search_batched", "list", "mark", "move", "delete", "search_to_me", "draft", "update_draft", "send_draft", "list_drafts", "reply_draft", "forward_draft"],
+                        description: "Action to perform: read (get email by ID), search (find emails), search_batched (find emails in batches of 50, up to 5 batches for better performance), list (folder contents), mark (read/unread), move (to folder), delete (permanently), search_to_me (emails addressed to you), draft (create standalone draft - NOTE: Use reply_draft/forward_draft for threaded drafts), update_draft (modify existing draft), send_draft (send saved draft), list_drafts (list draft emails), reply_draft (create threaded reply draft that appears in conversation), forward_draft (create threaded forward draft that appears in conversation)"
                     },
                     messageId: {
                         type: "string",
@@ -268,26 +292,45 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     },
                     maxResults: {
                         type: "number",
-                        description: "Maximum number of results to return (default: 50, max: 200)",
-                        minimum: 1,
-                        maximum: 200,
+                        description: "Maximum number of results to return. Set to 0 or omit to get ALL matching results (safety limited to 1000). For large result sets, use specific maxResults values to avoid timeouts. Default: 50",
+                        minimum: 0,
+                        default: 50
+                    },
+                    batchSize: {
+                        type: "number",
+                        description: "Number of results per batch for search_batched action (default: 50)",
+                        minimum: 10,
+                        maximum: 100,
                         default: 50
                     },
+                    maxBatches: {
+                        type: "number",
+                        description: "Maximum number of batches for search_batched action (default: 5)",
+                        minimum: 1,
+                        maximum: 10,
+                        default: 5
+                    },
                     // Draft email parameters
                     draftTo: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of recipient email addresses (required for draft action)"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "Recipient email address (string) or list of recipient email addresses (array) - required for draft action"
                     },
                     draftCc: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of CC recipient email addresses (optional for draft action)"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "CC recipient email address (string) or list of CC recipient email addresses (array) - optional for draft action"
                     },
                     draftBcc: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "List of BCC recipient email addresses (optional for draft action)"
+                        oneOf: [
+                            { type: "string" },
+                            { type: "array", items: { type: "string" } }
+                        ],
+                        description: "BCC recipient email address (string) or list of BCC recipient email addresses (array) - optional for draft action"
                     },
                     draftSubject: {
                         type: "string",
@@ -350,8 +393,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "Conversation ID for threading drafts (optional)"
                     }
                 },
-                required: ["action"],
-                additionalProperties: false
+                required: ["action"]
             }
         },
         {
@@ -373,8 +415,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "Attachment ID to download"
                     }
                 },
-                required: ["messageId", "attachmentId"],
-                additionalProperties: false
+                required: ["messageId", "attachmentId"]
             }
         },
         {
@@ -395,8 +436,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         type: "string",
                         description: "Optional: Search for folders by name (case-insensitive partial match)"
                     }
-                },
-                additionalProperties: false
+                }
             }
         },
         {
@@ -425,8 +465,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         minimum: 1,
                         maximum: 500
                     }
-                },
-                additionalProperties: false
+                }
             }
         }
     ];
@@ -442,8 +481,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         type: "string",
                         description: "User's email address (optional, for identification)"
                     }
-                },
-                additionalProperties: false
+                }
             }
         },
         {
@@ -457,8 +495,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "Your User ID to remove"
                     }
                 },
-                required: ["userId"],
-                additionalProperties: false
+                required: ["userId"]
             }
         }
     ];
@@ -486,8 +523,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         description: "Account key for logout action (default: current user)",
                         default: "default-user"
                     }
-                },
-                additionalProperties: false
+                }
             }
         }
     ];
@@ -722,6 +758,52 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 }
                             ]
                         };
+                    case "search_batched":
+                        const batchSize = args?.batchSize || 50;
+                        const maxBatches = args?.maxBatches || 5;
+                        logger.log(`DEBUG: Starting batched search with batchSize: ${batchSize}, maxBatches: ${maxBatches}`);
+                        const batchedSearchResults = await ms365Ops.searchEmailsBatched(args, batchSize, maxBatches);
+                        logger.log(`DEBUG: Batched search results count: ${batchedSearchResults.messages.length} from ${batchedSearchResults.totalBatches} batches`);
+                        // Enhanced feedback for batched search results
+                        let batchedResponseText = `🔍 Batched Email Search Results (${batchedSearchResults.messages.length} found from ${batchedSearchResults.totalBatches} batches)`;
+                        if (batchedSearchResults.messages.length === 0) {
+                            batchedResponseText = `🔍 No emails found matching your criteria.\n\n💡 Search Tips:\n`;
+                            if (args?.from) {
+                                batchedResponseText += `• Try partial names: "${args.from.split(' ')[0]}" or "${args.from.split(' ').pop()}"\n`;
+                                batchedResponseText += `• Check spelling of sender name\n`;
+                            }
+                            if (args?.subject) {
+                                batchedResponseText += `• Try broader subject terms\n`;
+                            }
+                            if (args?.after || args?.before) {
+                                batchedResponseText += `• Try expanding date range\n`;
+                            }
+                            batchedResponseText += `• Remove some search criteria to get broader results`;
+                        }
+                        else {
+                            batchedResponseText += `\n\n${batchedSearchResults.messages.map((email, index) => {
+                                // Handle missing IDs more gracefully
+                                const emailId = email.id || 'ID_MISSING';
+                                const fromDisplay = email.from?.name ? `${email.from.name} <${email.from.address}>` : email.from?.address || 'Unknown sender';
+                                return `${index + 1}. 📧 ${email.subject || 'No subject'}\n   👤 From: ${fromDisplay}\n   📅 ${email.receivedDateTime ? new Date(email.receivedDateTime).toLocaleDateString() : 'Unknown date'}\n   ${email.isRead ? '📖 Read' : '📩 Unread'}\n   🆔 ID: ${emailId}\n`;
+                            }).join('\n')}`;
+                            if (batchedSearchResults.hasMore) {
+                                batchedResponseText += `\n💡 There are more results available. Increase maxBatches parameter to get more emails.`;
+                            }
+                            batchedResponseText += `\n\n📊 Search Summary:\n`;
+                            batchedResponseText += `• Total results: ${batchedSearchResults.messages.length}\n`;
+                            batchedResponseText += `• Batches processed: ${batchedSearchResults.totalBatches}/${maxBatches}\n`;
+                            batchedResponseText += `• Batch size: ${batchSize}\n`;
+                            batchedResponseText += `• More results available: ${batchedSearchResults.hasMore ? 'Yes' : 'No'}`;
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: batchedResponseText
+                                }
+                            ]
+                        };
                     case "search_to_me":
                         const searchToMeResults = await ms365Ops.searchEmailsToMe(args);
                         // Process attachments for each email
@@ -851,15 +933,25 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         if (!args?.draftTo || !args?.draftSubject || !args?.draftBody) {
                             throw new Error("draftTo, draftSubject, and draftBody are required for draft action");
                         }
+                        // Helper function to normalize email arrays for drafts
+                        const normalizeDraftEmailArray = (field) => {
+                            if (!field)
+                                return [];
+                            if (typeof field === 'string')
+                                return [field];
+                            if (Array.isArray(field))
+                                return field;
+                            throw new Error(`Invalid email field format. Expected string or array of strings.`);
+                        };
                         // Check if this looks like a reply based on subject
                         const isLikelyReply = args.draftSubject?.toString().toLowerCase().startsWith('re:');
                         if (isLikelyReply) {
                             logger.log('🔔 SUGGESTION: Consider using "reply_draft" action instead of "draft" for threaded replies that appear in conversations');
                         }
                         const draftResult = await ms365Ops.saveDraftEmail({
-                            to: args.draftTo,
-                            cc: args.draftCc,
-                            bcc: args.draftBcc,
+                            to: normalizeDraftEmailArray(args.draftTo),
+                            cc: normalizeDraftEmailArray(args.draftCc),
+                            bcc: normalizeDraftEmailArray(args.draftBcc),
                             subject: args.draftSubject,
                             body: args.draftBody,
                             bodyType: args.draftBodyType || 'text',
@@ -884,13 +976,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         if (!args?.draftId) {
                             throw new Error("draftId is required for update_draft action");
                         }
+                        // Helper function to normalize email arrays for draft updates
+                        const normalizeUpdateEmailArray = (field) => {
+                            if (!field)
+                                return [];
+                            if (typeof field === 'string')
+                                return [field];
+                            if (Array.isArray(field))
+                                return field;
+                            throw new Error(`Invalid email field format. Expected string or array of strings.`);
+                        };
                         const updates = {};
                         if (args.draftTo)
-                            updates.to = args.draftTo;
+                            updates.to = normalizeUpdateEmailArray(args.draftTo);
                         if (args.draftCc)
-                            updates.cc = args.draftCc;
+                            updates.cc = normalizeUpdateEmailArray(args.draftCc);
                         if (args.draftBcc)
-                            updates.bcc = args.draftBcc;
+                            updates.bcc = normalizeUpdateEmailArray(args.draftBcc);
                         if (args.draftSubject)
                             updates.subject = args.draftSubject;
                         if (args.draftBody)
@@ -1018,7 +1120,36 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     const graphClient = await enhancedMS365Auth.getGraphClient();
                     ms365Ops.setGraphClient(graphClient);
                 }
-                const emailResult = await ms365Ops.sendEmail(args);
+                // Validate and normalize email input
+                if (!args?.to) {
+                    throw new Error("'to' field is required for sending email");
+                }
+                if (!args?.subject) {
+                    throw new Error("'subject' field is required for sending email");
+                }
+                // Helper function to normalize email arrays
+                const normalizeEmailArray = (field) => {
+                    if (!field)
+                        return [];
+                    if (typeof field === 'string')
+                        return [field];
+                    if (Array.isArray(field))
+                        return field;
+                    throw new Error(`Invalid email field format. Expected string or array of strings.`);
+                };
+                // Normalize the email message
+                const emailMessage = {
+                    to: normalizeEmailArray(args.to),
+                    cc: normalizeEmailArray(args.cc),
+                    bcc: normalizeEmailArray(args.bcc),
+                    subject: args.subject,
+                    body: args.body || '',
+                    bodyType: args.bodyType || 'text',
+                    replyTo: args.replyTo,
+                    importance: args.importance || 'normal',
+                    attachments: args.attachments || []
+                };
+                const emailResult = await ms365Ops.sendEmail(emailMessage);
                 return {
                     content: [
                         {