ms365-mcp-server 1.0.3 → 1.0.4

package/README.md

@@ -18,7 +18,7 @@ A powerful **Model Context Protocol (MCP) server** that enables seamless Microso
 ### 📧 Core Email Operations (12 tools)
 - **`send_email`** - Send emails with attachments, HTML/text content, CC/BCC
 - **`read_email`** - Read full email content including headers and attachments  
-- **`search_emails`** - Advanced search with filtering and date ranges
+- **`search_emails`** - Advanced search with intelligent partial name matching
 - **`search_emails_to_me`** - Find emails addressed to YOU (both TO and CC fields)
 - **`list_emails`** - List emails in inbox, sent, or custom folders
 - **`get_attachment`** - Download and retrieve email attachments
@@ -139,10 +139,12 @@ ms365-mcp-server --setup-auth
 
 ### 🔍 Email Search Options
 
-- **`search_emails`** - General search with manual recipient specification
-  - Requires you to specify email addresses in `to` or `cc` fields
-  - More flexible for searching any recipient combinations
-  - Example: `{"to": "someone@company.com", "from": "boss@company.com"}`
+- **`search_emails`** - Unified search with intelligent capabilities
+  - **Smart Name Matching**: Automatically detects names vs email addresses
+  - **Partial Name Support**: Search by "Madan", "Kumar", "M Kumar", etc.
+  - **Flexible Criteria**: Combine name search with date ranges, subjects, etc.
+  - **Email Address Matching**: Use exact email addresses when needed
+  - Example: `{"from": "Madan", "after": "2024-01-01"}` or `{"from": "boss@company.com"}`
 
 - **`search_emails_to_me`** - Automatic search for emails addressed to YOU
   - Automatically uses your email address for both TO and CC searches

package/dist/index.js

@@ -55,7 +55,7 @@ function parseArgs() {
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.0.3"
+    version: "1.0.4"
 }, {
     capabilities: {
         resources: {
@@ -197,7 +197,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         },
         {
             name: "search_emails",
-            description: "Search emails with various criteria including subject, sender, TO/CC recipients, date range, and advanced filtering. Supports complex queries and filtering, including emails addressed to you directly or where you were CC'd.",
+            description: "Search emails with various criteria including subject, sender, TO/CC recipients, date range, and advanced filtering. Features intelligent partial name matching for senders - just use their first name, last name, or partial name in the 'from' field. Supports complex queries and filtering, including emails addressed to you directly or where you were CC'd.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -911,28 +911,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }
                     ]
                 };
-            case "list_emails":
-                if (ms365Config.multiUser) {
-                    const userId = args?.userId;
-                    if (!userId) {
-                        throw new Error("User ID is required in multi-user mode");
-                    }
-                    const graphClient = await multiUserMS365Auth.getGraphClientForUser(userId);
-                    ms365Ops.setGraphClient(graphClient);
-                }
-                else {
-                    const graphClient = await enhancedMS365Auth.getGraphClient();
-                    ms365Ops.setGraphClient(graphClient);
-                }
-                const emailList = await ms365Ops.listEmails(args?.folderId, args?.maxResults);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `📬 Email List (${emailList.messages.length} emails)\n\n${emailList.messages.map((email, index) => `${index + 1}. 📧 ${email.subject}\n   👤 From: ${email.from.name} <${email.from.address}>\n   📅 ${new Date(email.receivedDateTime).toLocaleDateString()}\n   ${email.isRead ? '📖' : '📩'} ${email.isRead ? 'Read' : 'Unread'}\n   🆔 ID: ${email.id}\n`).join('\n')}`
-                        }
-                    ]
-                };
             case "mark_email":
                 if (ms365Config.multiUser) {
                     const userId = args?.userId;
@@ -1087,6 +1065,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }
                     ]
                 };
+            case "list_emails":
+                if (ms365Config.multiUser) {
+                    const userId = args?.userId;
+                    if (!userId) {
+                        throw new Error("User ID is required in multi-user mode");
+                    }
+                    const graphClient = await multiUserMS365Auth.getGraphClientForUser(userId);
+                    ms365Ops.setGraphClient(graphClient);
+                }
+                else {
+                    const graphClient = await enhancedMS365Auth.getGraphClient();
+                    ms365Ops.setGraphClient(graphClient);
+                }
+                const emailList = await ms365Ops.listEmails(args?.folderId, args?.maxResults);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `📬 Email List (${emailList.messages.length} emails)\n\n${emailList.messages.map((email, index) => `${index + 1}. 📧 ${email.subject}\n   👤 From: ${email.from.name} <${email.from.address}>\n   📅 ${new Date(email.receivedDateTime).toLocaleDateString()}\n   ${email.isRead ? '📖' : '📩'} ${email.isRead ? 'Read' : 'Unread'}\n   🆔 ID: ${email.id}\n`).join('\n')}`
+                        }
+                    ]
+                };
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/utils/ms365-operations.js

@@ -65,7 +65,20 @@ export class MS365Operations {
         // Build email-specific search terms using proper Microsoft Graph syntax
         const emailSearchTerms = [];
         if (criteria.from) {
-            emailSearchTerms.push(`from:${criteria.from}`);
+            // Check if it looks like an email address for exact matching
+            if (criteria.from.includes('@')) {
+                emailSearchTerms.push(`from:${criteria.from}`);
+            }
+            else {
+                // For names, use general search which is more flexible with partial matching
+                // This will trigger manual filtering which supports partial names better
+                if (criteria.query) {
+                    searchTerms.push(`${criteria.query} AND ${criteria.from}`);
+                }
+                else {
+                    searchTerms.push(criteria.from);
+                }
+            }
         }
         if (criteria.to) {
             emailSearchTerms.push(`to:${criteria.to}`);
@@ -224,7 +237,59 @@ export class MS365Operations {
     async searchEmails(criteria = {}) {
         try {
             const graphClient = await this.getGraphClient();
-            // Build search and filter queries
+            // For name-based searches, use enhanced approach for better partial matching
+            if (criteria.from && !criteria.from.includes('@')) {
+                logger.log(`Using enhanced name matching for: "${criteria.from}"`);
+                // Get more emails and filter manually for better name matching
+                const maxResults = criteria.maxResults || 100;
+                try {
+                    // Get broader set of emails for manual filtering
+                    const apiCall = graphClient.api('/me/messages')
+                        .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,sentDateTime,bodyPreview,isRead,hasAttachments,importance,conversationId,parentFolderId,webLink')
+                        .orderby('receivedDateTime desc')
+                        .top(Math.min(maxResults * 2, 200)); // Get more emails to filter from
+                    const result = await apiCall.get();
+                    let messages = result.value?.map((email) => ({
+                        id: email.id,
+                        subject: email.subject || '',
+                        from: {
+                            name: email.from?.emailAddress?.name || '',
+                            address: email.from?.emailAddress?.address || ''
+                        },
+                        toRecipients: email.toRecipients?.map((recipient) => ({
+                            name: recipient.emailAddress?.name || '',
+                            address: recipient.emailAddress?.address || ''
+                        })) || [],
+                        ccRecipients: email.ccRecipients?.map((recipient) => ({
+                            name: recipient.emailAddress?.name || '',
+                            address: recipient.emailAddress?.address || ''
+                        })) || [],
+                        receivedDateTime: email.receivedDateTime,
+                        sentDateTime: email.sentDateTime,
+                        bodyPreview: email.bodyPreview || '',
+                        isRead: email.isRead || false,
+                        hasAttachments: email.hasAttachments || false,
+                        importance: email.importance || 'normal',
+                        conversationId: email.conversationId || '',
+                        parentFolderId: email.parentFolderId || '',
+                        webLink: email.webLink || ''
+                    })) || [];
+                    // Apply manual filtering with enhanced name matching
+                    messages = this.applyManualFiltering(messages, criteria);
+                    // Apply maxResults limit
+                    const limitedMessages = messages.slice(0, maxResults);
+                    logger.log(`Enhanced name search found ${limitedMessages.length} emails matching "${criteria.from}"`);
+                    return {
+                        messages: limitedMessages,
+                        hasMore: messages.length > maxResults || !!result['@odata.nextLink']
+                    };
+                }
+                catch (error) {
+                    logger.error('Error in enhanced name search, falling back to standard search:', error);
+                    // Fall through to standard search logic
+                }
+            }
+            // Standard search logic (for email addresses and other criteria)
             const searchQuery = this.buildSearchQuery(criteria);
             const filterQuery = this.buildFilterQuery(criteria);
             // Debug logging
@@ -395,9 +460,29 @@ export class MS365Operations {
                     return false;
             }
             if (criteria.from) {
-                const fromMatch = message.from.address.toLowerCase().includes(criteria.from.toLowerCase()) ||
-                    message.from.name.toLowerCase().includes(criteria.from.toLowerCase());
-                if (!fromMatch)
+                const searchTerm = criteria.from.toLowerCase().trim();
+                const fromName = message.from.name.toLowerCase();
+                const fromAddress = message.from.address.toLowerCase();
+                // Multiple matching strategies for better partial name support
+                const matches = [
+                    // Direct name or email match
+                    fromName.includes(searchTerm),
+                    fromAddress.includes(searchTerm),
+                    // Split search term and check if all parts exist in name
+                    searchTerm.split(/\s+/).every(part => fromName.includes(part)),
+                    // Check if any word in the name starts with the search term
+                    fromName.split(/\s+/).some(namePart => namePart.startsWith(searchTerm)),
+                    // Check if search term matches any word in the name exactly
+                    fromName.split(/\s+/).some(namePart => namePart === searchTerm),
+                    // Handle "Last, First" format
+                    fromName.replace(/,\s*/g, ' ').includes(searchTerm),
+                    // Handle initials (e.g., "M Kumar" for "Madan Kumar")
+                    searchTerm.split(/\s+/).length === 2 &&
+                        fromName.split(/\s+/).length >= 2 &&
+                        fromName.split(/\s+/)[0].startsWith(searchTerm.split(/\s+/)[0][0]) &&
+                        fromName.includes(searchTerm.split(/\s+/)[1])
+                ];
+                if (!matches.some(match => match))
                     return false;
             }
             if (criteria.to) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms365-mcp-server",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Microsoft 365 MCP Server for managing Microsoft 365 email through natural language interactions with full OAuth2 authentication support",
   "main": "dist/index.js",
   "type": "module",