ms365-mcp-server 1.1.18 → 1.1.20

package/README.md

@@ -12,6 +12,12 @@ A powerful **Model Context Protocol (MCP) server** that enables seamless Microso
 - **📁 Smart Contact Management** - Search and retrieve your Microsoft 365 contacts
 - **🌐 Cross-Platform** - Works on macOS, Linux, and Windows
 
+## 📚 Documentation
+
+For detailed technical documentation, enhancement reports, and guides, see the **[docs/](./docs/)** directory:
+- **[Enhancement Reports](./docs/MS365-MCP-Server-Enhancement-Report.md)** - Recent fixes and improvements
+- **[Technical Guides](./docs/)** - Batch operations and Graph API implementation guides
+
 ## 🛠️ Available Tools (6 Total)
 
 ### **📧 Email Management**

package/dist/index.js

@@ -83,7 +83,7 @@ function parseArgs() {
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.1.18"
+    version: "1.1.19"
 }, {
     capabilities: {
         resources: {

package/dist/utils/config-dir.js

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+/**
+ * Get configuration directory with simple fallback logic
+ * 1. First try: os.homedir()/.ms365-mcp
+ * 2. Fallback: /home/siya/.ms365-mcp
+ */
+export function getConfigDir() {
+    const primaryPath = path.join(os.homedir(), '.ms365-mcp');
+    const fallbackPath = '/home/siya/.ms365-mcp';
+    // Check if primary path exists or can be created
+    try {
+        if (fs.existsSync(primaryPath)) {
+            return primaryPath;
+        }
+        // Try to create primary path
+        fs.mkdirSync(primaryPath, { recursive: true });
+        return primaryPath;
+    }
+    catch (error) {
+        // If primary path fails, use fallback
+        try {
+            if (!fs.existsSync(fallbackPath)) {
+                fs.mkdirSync(fallbackPath, { recursive: true });
+            }
+            return fallbackPath;
+        }
+        catch (fallbackError) {
+            // If everything fails, return primary path anyway
+            return primaryPath;
+        }
+    }
+}
+/**
+ * Check if config files exist in a directory
+ */
+export function hasConfigFiles(dirPath) {
+    const credentialsFile = path.join(dirPath, 'credentials.json');
+    const tokenFile = path.join(dirPath, 'token.json');
+    const msalCacheFile = path.join(dirPath, 'msal-cache.json');
+    return fs.existsSync(credentialsFile) ||
+        fs.existsSync(tokenFile) ||
+        fs.existsSync(msalCacheFile);
+}
+/**
+ * Get configuration directory, checking fallback if no config files found in primary
+ */
+export function getConfigDirWithFallback() {
+    const primaryPath = path.join(os.homedir(), '.ms365-mcp');
+    const fallbackPath = '/home/siya/.ms365-mcp';
+    // If primary path has config files, use it
+    if (fs.existsSync(primaryPath) && hasConfigFiles(primaryPath)) {
+        return primaryPath;
+    }
+    // If fallback path has config files, use it
+    if (fs.existsSync(fallbackPath) && hasConfigFiles(fallbackPath)) {
+        return fallbackPath;
+    }
+    // Default to primary path for new installations
+    return getConfigDir();
+}

package/dist/utils/ms365-auth-enhanced.js

@@ -2,12 +2,12 @@ import { ConfidentialClientApplication, PublicClientApplication } from '@azure/m
 import { Client } from '@microsoft/microsoft-graph-client';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as os from 'os';
 import open from 'open';
 import { createServer } from 'http';
 import { URL } from 'url';
 import { logger } from './api.js';
 import { credentialStore } from './credential-store.js';
+import { getConfigDirWithFallback } from './config-dir.js';
 // Scopes required for Microsoft 365 operations
 const SCOPES = [
     'https://graph.microsoft.com/Mail.ReadWrite',
@@ -21,7 +21,7 @@ const SCOPES = [
 const BUILTIN_CLIENT_ID = "14d82eec-204b-4c2f-b7e8-296a70dab67e"; // Microsoft Graph Command Line Tools
 const DEFAULT_TENANT_ID = "common";
 // Configuration directory and file paths
-const CONFIG_DIR = path.join(os.homedir(), '.ms365-mcp');
+const CONFIG_DIR = getConfigDirWithFallback();
 const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.json');
 const DEVICE_CODE_FILE = path.join(CONFIG_DIR, 'device-code.json');
 const TOKEN_CACHE_FILE = path.join(CONFIG_DIR, 'msal-cache.json');

package/dist/utils/ms365-auth.js

@@ -2,11 +2,11 @@ import { ConfidentialClientApplication } from '@azure/msal-node';
 import { Client } from '@microsoft/microsoft-graph-client';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as os from 'os';
 import open from 'open';
 import { createServer } from 'http';
 import { URL } from 'url';
 import { logger } from './api.js';
+import { getConfigDirWithFallback } from './config-dir.js';
 // Scopes required for Microsoft 365 operations
 const SCOPES = [
     'https://graph.microsoft.com/Mail.ReadWrite',
@@ -17,7 +17,7 @@ const SCOPES = [
     'offline_access'
 ];
 // Configuration directory and file paths
-const CONFIG_DIR = path.join(os.homedir(), '.ms365-mcp');
+const CONFIG_DIR = getConfigDirWithFallback();
 const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.json');
 const TOKEN_FILE = path.join(CONFIG_DIR, 'token.json');
 /**

package/dist/utils/ms365-operations.js

@@ -7,7 +7,7 @@ export class MS365Operations {
     constructor() {
         this.graphClient = null;
         this.searchCache = new Map();
-        this.CACHE_DURATION = 60 * 1000; // 1 minute cache
+        this.CACHE_DURATION = 300 * 1000; // 5 minute cache for better performance
         this.MAX_RETRIES = 3;
         this.BASE_DELAY = 1000; // 1 second
     }
@@ -1624,7 +1624,18 @@ ${originalBodyContent}
             // Other filters remain the same but are more robust
             if (criteria.to && !message.toRecipients.some(r => r.address.toLowerCase().includes(criteria.to.toLowerCase())))
                 return false;
-            if (criteria.cc && (!message.ccRecipients || !message.ccRecipients.some(r => r.address.toLowerCase().includes(criteria.cc.toLowerCase()))))
+            if (criteria.cc && (!message.ccRecipients || !message.ccRecipients.some(r => {
+                const searchTerm = criteria.cc.toLowerCase().trim();
+                const recipientName = r.name.toLowerCase();
+                const recipientAddress = r.address.toLowerCase();
+                // Multiple matching strategies for robust CC filtering
+                return (recipientAddress === searchTerm ||
+                    recipientAddress.includes(searchTerm) ||
+                    recipientName === searchTerm ||
+                    recipientName.includes(searchTerm) ||
+                    searchTerm.split(/\s+/).every(part => recipientName.includes(part)) ||
+                    new RegExp(`\\b${searchTerm.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'i').test(recipientName));
+            })))
                 return false;
             if (criteria.subject && !message.subject.toLowerCase().includes(criteria.subject.toLowerCase()))
                 return false;
@@ -2402,8 +2413,26 @@ ${originalBodyContent}
                     return false;
             }
             if (criteria.cc) {
+                const searchTerm = criteria.cc.toLowerCase().trim();
                 const ccMatch = message.ccRecipients && message.ccRecipients.length > 0 &&
-                    message.ccRecipients.some(recipient => recipient.address.toLowerCase() === criteria.cc.toLowerCase());
+                    message.ccRecipients.some(recipient => {
+                        const recipientName = recipient.name.toLowerCase();
+                        const recipientAddress = recipient.address.toLowerCase();
+                        // Multiple matching strategies for robust CC filtering (same as TO)
+                        return (
+                        // Exact email match
+                        recipientAddress === searchTerm ||
+                            // Email contains search term
+                            recipientAddress.includes(searchTerm) ||
+                            // Full name match
+                            recipientName === searchTerm ||
+                            // Name contains search term
+                            recipientName.includes(searchTerm) ||
+                            // Split name matching (for "first last" searches)
+                            searchTerm.split(/\s+/).every(part => recipientName.includes(part)) ||
+                            // Word boundary matching
+                            new RegExp(`\\b${searchTerm.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'i').test(recipientName));
+                    });
                 if (!ccMatch)
                     return false;
             }

package/dist/utils/multi-user-auth.js

@@ -2,11 +2,11 @@ import { ConfidentialClientApplication } from '@azure/msal-node';
 import { Client } from '@microsoft/microsoft-graph-client';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as os from 'os';
 import { createServer } from 'http';
 import { URL } from 'url';
 import { logger } from './api.js';
 import { createHash, randomBytes } from 'crypto';
+import { getConfigDirWithFallback } from './config-dir.js';
 // Scopes required for Microsoft 365 operations
 const SCOPES = [
     'https://graph.microsoft.com/Mail.ReadWrite',
@@ -17,7 +17,7 @@ const SCOPES = [
     'offline_access'
 ];
 // Configuration directory
-const CONFIG_DIR = path.join(os.homedir(), '.ms365-mcp');
+const CONFIG_DIR = getConfigDirWithFallback();
 /**
  * Multi-user Microsoft 365 authentication manager
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms365-mcp-server",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "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",