ms365-mcp-server 1.0.1 → 1.0.2

package/README.md

@@ -1,15 +1,12 @@
 # ✉️ Microsoft 365 MCP Server
 
-A powerful **Model Context Protocol (MCP) server** that enables seamless Microsoft 365 email integration through natural language interactions. Built for **Claude Desktop**, **LLMs**, and any MCP-compatible application with **enhanced security** and **simplified authentication**.
-
-This project provides an **MCP (Model Context Protocol) server** that enables **Claude Desktop** to access your **Microsoft 365 email** seamlessly. It acts as a bridge between AI models and email services by exposing mailbox capabilities through a **secure, standardized interface**.
+A powerful **Model Context Protocol (MCP) server** that enables seamless Microsoft 365 email integration through natural language interactions. Built for **Claude Desktop**, **LLMs**, and any MCP-compatible application with **production-ready security**.
 
 ## ✨ Key Features
 
 - **Complete Microsoft 365 integration** with OAuth2 security via Azure MSAL
 - **Intuitive email management** - send, read, search, and organize emails
 - **Smart email search** with advanced filtering and criteria support
-- **Email organization** with read/unread marking and folder management
 - **File attachment support** - send and receive attachments seamlessly
 - **Enhanced security** with simplified single-user authentication model
 - **Contact management** - retrieve and search your contact directory
@@ -18,10 +15,11 @@ This project provides an **MCP (Model Context Protocol) server** that enables **
 
 ## 🛠️ Tools & Capabilities
 
-### 📧 Core Email Operations (11 tools)
+### 📧 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_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
 - **`mark_email`** - Mark emails as read or unread
@@ -31,98 +29,24 @@ This project provides an **MCP (Model Context Protocol) server** that enables **
 - **`get_contacts`** - Retrieve contact list from Microsoft 365
 - **`search_contacts`** - Search contacts by name or email address
 
-### 🔐 Secure Authentication Tools (7 tools)
-- **`authenticate_with_device_code`** - Complete authentication in one step (RECOMMENDED)
-- **`device_code_login`** - Device code authentication flow (manual code entry)
+### 🔐 Authentication Tools (6 tools)
+- **`authenticate_with_device_code`** - Complete authentication in MCP (RECOMMENDED)
+- **`device_code_login`** - Start device code authentication flow
 - **`check_pending_auth`** - Check for pending device code authentication
-- **`get_device_code`** - Get device code info for manual authentication
-- **`get_auth_link`** - Get authentication link without auto browser launch
-- **`verify_authentication`** - Check current authentication status (secure)
+- **`verify_authentication`** - Check current authentication status
 - **`logout`** - Clear authentication tokens and reset session
+- **`get_device_code`** - Get device code info for manual authentication
 
-**Total: 18 tools** (11 email operations + 7 secure authentication tools)
-
-## 🌟 Key Feature Highlights
-
-### ✅ Supported Email Features
-
-* **Email Sending**
-  * Send plain text or HTML emails
-  * Add attachments and send in bulk
-  * Support for CC, BCC, and reply-to addresses
-  * Email importance levels (low, normal, high)
-
-* **Email Receiving & Querying**
-  * List folders and retrieve email metadata
-  * Advanced queries: filter by sender, subject, date, or addressed recipient (To/CC)
-  * View full email contents with attachments
-  * **Filter emails addressed to you directly (in To or CC)**
-
-* **Email Management**
-  * Mark emails as read/unread
-  * Delete or move emails between folders
-  * Organize emails with folder navigation
-
-* **Attachment Handling**
-  * List and download attachments
-  * Send emails with multiple attachments
-  * Support for various file types
-
-* **Contact Management**
-  * Retrieve contact list
-  * Perform smart contact searches
-  * Integration with Microsoft 365 address book
-
-### 🛡️ Enhanced Security Features
-
-* **Simplified Authentication Model**
-  * Single-user authentication for better security
-  * No account enumeration or information disclosure
-  * Secure credential storage with OS keychain integration
-
-* **Privacy Protection**
-  * No sensitive system information exposed
-  * User can only see their own authentication status
-  * Secure token management with automatic refresh
-
-* **Device Code Authentication**
-  * No browser auto-open for better security control
-  * Manual code entry prevents unauthorized access
-  * Built-in Microsoft app requires no Azure registration
-
-### 🌟 Advanced Features
-
-* **Advanced Search Filters**
-  * Multi-folder search capabilities
-  * Keyword, date range, sender/recipient matching
-  * **Identify and filter emails where the user is in To or CC**
-  * Attachment and importance level filtering
-
-* **Smart Contact Intelligence**
-  * Automatically extract contact metadata
-  * Search by name, email, or company information
-
-* **Content Range Control**
-  * Load large emails in parts to improve performance
-  * Efficient pagination for large result sets
-
-* **Rich Email Format Support**
-  * Compose and display both plain text and HTML emails
-  * Proper MIME type handling
-
-* **Secure and Local Processing**
-  * All email operations are handled **locally**
-  * No data is forwarded to third-party servers
-  * OAuth2 compliance with Azure MSAL
+**Total: 18 tools** (12 email operations + 6 authentication tools)
 
 ## 🚀 Quick Start
 
 ### Installation
 ```bash
-# Global installation (recommended)
+# Global installation
 npm install -g ms365-mcp-server
 
-# Quick device code authentication (no Azure app needed!)
+# Authenticate (no Azure app registration needed!)
 ms365-mcp-server --login
 
 # Start the server
@@ -143,324 +67,153 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-### First Time Authentication  
-**Device Code Flow (Recommended & Secure)**
-```bash
-ms365-mcp-server --login
-# Follow the on-screen instructions - no Azure app registration needed!
-```
-
-**Interactive Setup (Advanced)**
-```bash
-ms365-mcp-server --setup-auth
-# Choose device code flow (recommended) or custom Azure app
-```
-
-## 🔐 **Enhanced Security & Authentication**
-
-Our MS365 MCP Server features a **security-first authentication system** with simplified single-user model:
-
-### **🔒 Security Improvements**
-
-- **🚫 No Account Enumeration**: Removed tools that could expose user lists
-- **🚫 No System Information Disclosure**: Hidden sensitive storage details  
-- **🚫 No Multi-User Complexity**: Simplified to single-user for better security
-- **✅ Secure Credential Storage**: OS Keychain with encrypted file fallback
-- **✅ Privacy Protection**: Users can only see their own information
-- **✅ Token Security**: Automatic refresh with secure MSAL library
-
-### **🎯 Secure Authentication Flow**
-
-1. **🔥 Device Code Flow (Recommended)**
-   - **No Azure app registration required**
-   - **Built-in Microsoft app** for instant setup
-   - **Manual code entry** prevents unauthorized access
-   - **No local server** required (more secure)
-
-2. **⚙️ Custom Azure App (Advanced)**
-   - **Full control** over permissions and settings
-   - **Redirect-based OAuth2** authentication
-   - **Custom tenant configuration**
-   - Requires Azure app registration
-
-### **⚡ Secure Authentication Commands**
+## 🔐 Authentication
 
+### Simple Setup (Recommended)
 ```bash
-# Device code authentication (most secure)
+# One-command authentication - no Azure registration required!
 ms365-mcp-server --login
-
-# Verify your authentication status
-ms365-mcp-server --verify-login
-
-# Secure logout and clear tokens
-ms365-mcp-server --logout
-
-# Interactive credential setup
-ms365-mcp-server --setup-auth
-```
-
-### **🔄 Authentication Flow**
-
-| Feature | Device Code Flow *(Recommended)* | Redirect Flow *(Advanced)* |
-|---------|----------------------------------|----------------------------|
-| **Setup Required** | ❌ None (uses built-in app) | ✅ Azure app registration |
-| **Security** | 🔒 High (no local server) | 🔒 High (local callback) |
-| **Privacy** | 🔒 Manual code entry | 🔒 Browser auto-open |
-| **Ease of Use** | ✅ Simple setup | ⚙️ Advanced configuration |
-
-**Most users should use Device Code Flow** - it's simpler, more secure, and requires no setup!
-
-## 🛠️ Installation & Setup
-
-### Global Installation
-
-```bash
-npm install -g ms365-mcp-server
-```
-
-### Manual Installation
-
-```bash
-# Clone and build
-git clone <repository-url>
-cd ms365-mcp-server
-npm install
-npm run build
-
-# Set up authentication
-node dist/index.js --setup-auth
-
-# Start server
-node dist/index.js
 ```
 
-## 🔑 Authentication Setup
-
-### Step 1: Recommended Setup (No Azure Registration)
+### MCP Authentication Flow
+1. **Call**: `authenticate_with_device_code`
+2. **Get**: Device code and URL in the response
+3. **Visit**: https://microsoft.com/devicelogin  
+4. **Enter**: The provided device code
+5. **Call**: `authenticate_with_device_code` again
+6. **Done**: ✅ Authenticated and ready!
 
-**Most users should use this method:**
+### Advanced Setup (Custom Azure App)
+For advanced users who want custom Azure app configuration:
 
-```bash
-# One-command authentication
-ms365-mcp-server --login
-```
-
-This uses a built-in Microsoft app with device code flow - **no Azure registration needed!**
-
-### Step 2: Advanced Setup (Custom Azure App)
-
-> **💡 Note**: Only needed for advanced users who want custom Azure app configuration.
-
-1. Go to [Azure Portal](https://portal.azure.com)
-2. Navigate to **Azure Active Directory** > **App registrations**
-3. Click **"New registration"**
-4. Configure your application:
-   - **Name**: MS365 MCP Server (or your preferred name)
-   - **Supported account types**: Choose appropriate option
-   - **Redirect URI**: `http://localhost:44001/oauth2callback` *(only for redirect flow)*
-5. **Grant API permissions** for Microsoft Graph:
-   - `Mail.ReadWrite` - Read and write access to user mail
-   - `Mail.Send` - Send mail as user
-   - `MailboxSettings.Read` - Read user mailbox settings
-   - `Contacts.Read` - Read user contacts
-   - `User.Read` - Sign in and read user profile
-6. **Create client secret** in "Certificates & secrets"
-7. Note down:
-   - **Application (client) ID**
-   - **Directory (tenant) ID** 
-   - **Client secret value**
-
-### Step 3: Configure Credentials (Advanced Only)
-
-**Method 1: Environment Variables**
-```bash
-export MS365_CLIENT_ID="your_client_id_here"
-export MS365_CLIENT_SECRET="your_client_secret_here"
-export MS365_TENANT_ID="your_tenant_id_here"
-```
-
-**Method 2: Interactive Setup**
 ```bash
 ms365-mcp-server --setup-auth
-# Follow the prompts to enter your credentials
+# Follow prompts for custom client ID/secret
 ```
 
 ## 📖 Usage Examples
 
-### Sending Emails
+### Email Operations
 ```javascript
+// Send an email with attachment
 {
   "tool": "send_email",
   "arguments": {
     "to": ["colleague@company.com"],
     "subject": "Project Update",
-    "body": "<h2>Status Report</h2><p>The project is <b>on track</b>!</p>",
+    "body": "<h2>Status Report</h2><p>Project is on track!</p>",
     "bodyType": "html",
-    "importance": "high",
     "attachments": [{
       "name": "report.pdf",
-      "contentBytes": "base64_encoded_content",
-      "contentType": "application/pdf"
+      "contentBytes": "base64_encoded_content"
     }]
   }
 }
-```
 
-### Advanced Email Search
-```javascript
+// Search emails with advanced criteria
 {
-  "tool": "search_emails",
+  "tool": "search_emails", 
   "arguments": {
     "from": "boss@company.com",
     "after": "2024-01-01",
-    "hasAttachment": true,
-    "isUnread": true,
-    "maxResults": 20
+    "hasAttachment": true
   }
 }
-```
 
-### Secure Authentication Check
-```javascript
+// Find all emails addressed to YOU (both TO and CC)
 {
-  "tool": "verify_authentication",
-  "arguments": {}
+  "tool": "search_emails_to_me",
+  "arguments": {
+    "from": "important-sender@company.com",
+    "isUnread": true,
+    "after": "2024-01-01"
+  }
 }
-```
 
-### Contact Search
-```javascript
+// Check authentication
 {
-  "tool": "search_contacts",
-  "arguments": {
-    "query": "John Smith",
-    "maxResults": 10
-  }
+  "tool": "verify_authentication",
+  "arguments": {}
 }
 ```
 
-## 🎯 Command Line Options
+### 🔍 Email Search Options
 
-- `--setup-auth` - Configure Microsoft 365 API credentials
-- `--login` - Login using device code flow (recommended)
-- `--logout` - Logout and clear stored authentication tokens
-- `--verify-login` - Verify current authentication status
-- `--reset-auth` - Clear stored authentication tokens  
-- `--debug` - Enable detailed debug logging
-- `--help` - Show help information
+- **`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"}`
 
-🔒 **Security Note**: Removed `--multi-user` mode for enhanced security and simplicity.
+- **`search_emails_to_me`** - Automatic search for emails addressed to YOU
+  - Automatically uses your email address for both TO and CC searches
+  - Finds ALL emails where you are a recipient (direct or CC'd)
+  - No need to specify your email address manually
+  - Example: `{"from": "boss@company.com", "isUnread": true}`
 
-## 🔒 Security & Privacy
-
-- **Secure token storage** with OS Keychain integration
-- **Encrypted file fallback** for cross-platform compatibility
-- **OAuth2 compliance** with Microsoft MSAL library
-- **No external data transmission** - all data stays local
-- **Automatic token refresh** with secure credential management
-- **Privacy protection** - users can only access their own data
-- **No information disclosure** - system details are protected
+## 🎯 Command Line Options
 
-## 📊 Logging & Debugging
+- `--login` - Authenticate using device code flow (recommended)
+- `--logout` - Clear stored authentication tokens
+- `--verify-login` - Check current authentication status
+- `--setup-auth` - Interactive credential setup
+- `--reset-auth` - Clear all stored authentication data
+- `--debug` - Enable detailed debug logging
 
-Debug logs are written to: `/tmp/ms365-mcp-server.log`
+## 🛡️ Security Features
 
-Enable debug mode:
-```bash
-ms365-mcp-server --debug
-```
+- **Device Code Authentication** - No browser auto-open, manual code entry
+- **OS Keychain Integration** - Secure token storage with encrypted fallback
+- **Single-User Model** - Simplified security, no account enumeration
+- **Privacy Protection** - Users see only their own information
+- **OAuth2 Compliance** - Microsoft MSAL library with automatic refresh
+- **Local Processing** - No data transmitted to third-party servers
 
 ## 🚨 Troubleshooting
 
 ### Common Issues
 
 **"MS365 credentials not configured"**
-- Run `ms365-mcp-server --login` for quick setup
-- Use `--setup-auth` for advanced configuration
+```bash
+ms365-mcp-server --login
+```
 
 **Device code authentication issues**
-- Use `ms365-mcp-server --verify-login` to check status
-- Try `ms365-mcp-server --logout` then `--login` to reset
+```bash
+ms365-mcp-server --verify-login  # Check status
+ms365-mcp-server --logout        # Reset if needed
+ms365-mcp-server --login         # Re-authenticate
+```
 
 **Authentication timeout**
 - Device codes expire in 15 minutes
-- Use `--reset-auth` to clear old tokens and start fresh
-
-**Permission errors**
-- Verify Microsoft Graph API permissions if using custom Azure app
-- Device code flow handles permissions automatically
+- Use `--reset-auth` to clear old tokens
 
-### Reset Authentication
+### Debug Logs
 ```bash
-ms365-mcp-server --reset-auth
+ms365-mcp-server --debug
+# Logs written to: /tmp/ms365-mcp-server.log
 ```
 
 ## 🔧 Development
 
-### Local Development
 ```bash
+# Local development
 npm run dev
-```
 
-### Build Project
-```bash
+# Build project
 npm run build
-```
-
-### Version Management
-```bash
-# Bump patch version (1.0.0 → 1.0.1)
-npm run version-bump
-
-# Bump minor version (1.0.0 → 1.1.0)
-npm run version-bump minor
 
-# Bump major version (1.0.0 → 2.0.0)
-npm run version-bump major
+# Version management
+npm run version-bump [patch|minor|major]
 ```
 
 ## 🧠 Perfect for AI Assistants
 
-- **Claude Desktop integration** - Add Microsoft 365 to your Claude conversations
-- **Personal email assistant** - Let AI help manage your inbox intelligently  
+- **Claude Desktop integration** - Add Microsoft 365 to Claude conversations
 - **Email automation** - Build smart workflows and email processing
-- **Email analysis** - Extract insights and patterns from your email data
-- **Customer support** - Streamline email-based customer interactions
-- **Research assistance** - Query and analyze email communications
-- **Email productivity** - Automate routine email tasks and responses
-
-## 🆚 **Enhanced Security vs Other Implementations**
-
-Our implementation prioritizes **security and simplicity** over feature complexity:
-
-### **🛡️ Our Security-First Advantages**
-
-| Feature | Our Implementation | Other Implementations |
-|---------|-------------------|----------------------|
-| **Account Enumeration** | 🚫 Blocked (security risk) | ✅ Often exposed |
-| **System Information** | 🚫 Hidden (privacy protection) | ✅ Often exposed |
-| **Multi-User Complexity** | 🚫 Simplified to single-user | ✅ Complex multi-user |
-| **Authentication Model** | ✅ Secure device code focus | ⚠️ Various approaches |
-| **Information Disclosure** | 🚫 Minimized | ⚠️ Often excessive |
-| **Privacy Protection** | ✅ User sees only own data | ⚠️ Variable |
-
-### **🚀 Security Features**
-
-- **Privacy by Design**: Users can only access their own information
-- **Minimal Information Disclosure**: No sensitive system details exposed
-- **Simplified Authentication**: Single-user model reduces attack surface
-- **Secure Token Management**: OS keychain with automatic refresh
-- **Device Code Focus**: More secure than redirect-based flows
-
-### **🔄 Migration Considerations**
-
-**Enhanced Security Benefits:**
-- **Reduced Attack Surface**: Fewer tools mean less potential vulnerabilities
-- **Privacy Protection**: No account enumeration or system information disclosure
-- **Simplified Model**: Single-user approach is more secure and easier to audit
-- **Security Transparency**: Clear notices about what information is protected
-
-Choose our implementation for **maximum security and privacy protection** in your Microsoft 365 integrations.
+- **Inbox management** - Let AI help organize and respond to emails
+- **Email analysis** - Extract insights and patterns from email data
+- **Customer support** - Streamline email-based interactions
 
 ## 📝 License
 
@@ -468,15 +221,10 @@ MIT License - see LICENSE file for details.
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## 📞 Support
-
-For issues and questions:
-- Check the troubleshooting section above
-- Review debug logs in `/tmp/ms365-mcp-server.log`
-- Open an issue on the project repository
+Contributions welcome! Please feel free to submit a Pull Request.
 
 ---
 
-**Built with 🔒 Security and ❤️ for the AI and productivity community** 
+**Built with 🔒 Security and ❤️ for the AI community** 
+
+*Production-ready Microsoft 365 integration for Claude Desktop and MCP applications*

package/dist/index.js

@@ -55,7 +55,7 @@ function parseArgs() {
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.0.1"
+    version: "1.0.2"
 }, {
     capabilities: {
         resources: {
@@ -261,6 +261,64 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 additionalProperties: false
             }
         },
+        {
+            name: "search_emails_to_me",
+            description: "Search for emails addressed to YOU in both TO and CC fields. This automatically finds all emails where you are a recipient (direct TO or CC'd), without needing to specify your email address.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    userId: {
+                        type: "string",
+                        description: "User ID for multi-user authentication (required if using multi-user mode)"
+                    },
+                    query: {
+                        type: "string",
+                        description: "General search query using natural language or specific terms"
+                    },
+                    from: {
+                        type: "string",
+                        description: "Search for emails from specific sender"
+                    },
+                    subject: {
+                        type: "string",
+                        description: "Search for emails with specific subject"
+                    },
+                    after: {
+                        type: "string",
+                        description: "Search for emails after date (format: YYYY-MM-DD)"
+                    },
+                    before: {
+                        type: "string",
+                        description: "Search for emails before date (format: YYYY-MM-DD)"
+                    },
+                    hasAttachment: {
+                        type: "boolean",
+                        description: "Filter emails that have attachments"
+                    },
+                    folder: {
+                        type: "string",
+                        description: "Search within specific folder (default: inbox)"
+                    },
+                    isUnread: {
+                        type: "boolean",
+                        description: "Filter for unread emails only"
+                    },
+                    importance: {
+                        type: "string",
+                        enum: ["low", "normal", "high"],
+                        description: "Filter by email importance level"
+                    },
+                    maxResults: {
+                        type: "number",
+                        description: "Maximum number of results to return (default: 50, max: 200)",
+                        minimum: 1,
+                        maximum: 200,
+                        default: 50
+                    }
+                },
+                additionalProperties: false
+            }
+        },
         {
             name: "list_emails",
             description: "List emails in inbox, sent, or custom folder. Returns basic email information including subjects, senders, and snippets with support for folder navigation.",
@@ -831,6 +889,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }
                     ]
                 };
+            case "search_emails_to_me":
+                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 searchToMeResults = await ms365Ops.searchEmailsToMe(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `🔍 Emails Addressed to You (TO & CC) - ${searchToMeResults.messages.length} found\n\n${searchToMeResults.messages.map((email, index) => `${index + 1}. 📧 ${email.subject}\n   👤 From: ${email.from.name} <${email.from.address}>\n   📅 ${new Date(email.receivedDateTime).toLocaleDateString()}\n   🆔 ID: ${email.id}\n`).join('\n')}`
+                        }
+                    ]
+                };
             case "list_emails":
                 if (ms365Config.multiUser) {
                     const userId = args?.userId;

package/dist/utils/ms365-operations.js

@@ -389,16 +389,14 @@ export class MS365Operations {
                     return false;
             }
             if (criteria.to) {
-                const toMatch = message.toRecipients.some(recipient => recipient.address.toLowerCase().includes(criteria.to.toLowerCase()) ||
-                    recipient.name.toLowerCase().includes(criteria.to.toLowerCase()));
+                const toMatch = message.toRecipients.some(recipient => recipient.address.toLowerCase() === criteria.to.toLowerCase());
                 if (!toMatch)
                     return false;
             }
             if (criteria.cc) {
                 // Handle case where ccRecipients might be undefined
                 const ccMatch = message.ccRecipients && message.ccRecipients.length > 0 &&
-                    message.ccRecipients.some(recipient => recipient.address.toLowerCase().includes(criteria.cc.toLowerCase()) ||
-                        recipient.name.toLowerCase().includes(criteria.cc.toLowerCase()));
+                    message.ccRecipients.some(recipient => recipient.address.toLowerCase() === criteria.cc.toLowerCase());
                 if (!ccMatch)
                     return false;
             }
@@ -640,5 +638,61 @@ export class MS365Operations {
             throw error;
         }
     }
+    /**
+     * Get current user's email address
+     */
+    async getCurrentUserEmail() {
+        try {
+            const graphClient = await this.getGraphClient();
+            const user = await graphClient
+                .api('/me')
+                .select('mail,userPrincipalName')
+                .get();
+            return user.mail || user.userPrincipalName || '';
+        }
+        catch (error) {
+            logger.error('Error getting current user email:', error);
+            throw error;
+        }
+    }
+    /**
+     * Search for emails addressed to the current user (both TO and CC recipients)
+     */
+    async searchEmailsToMe(additionalCriteria = {}) {
+        try {
+            const userEmail = await this.getCurrentUserEmail();
+            // First search for emails where user is in TO field
+            const toCriteria = {
+                ...additionalCriteria,
+                to: userEmail
+            };
+            // Then search for emails where user is in CC field
+            const ccCriteria = {
+                ...additionalCriteria,
+                cc: userEmail
+            };
+            // Execute both searches in parallel
+            const [toResults, ccResults] = await Promise.all([
+                this.searchEmails(toCriteria),
+                this.searchEmails(ccCriteria)
+            ]);
+            // Combine results and remove duplicates based on email ID
+            const allMessages = [...toResults.messages, ...ccResults.messages];
+            const uniqueMessages = allMessages.filter((message, index, array) => array.findIndex(m => m.id === message.id) === index);
+            // Sort by received date (newest first)
+            uniqueMessages.sort((a, b) => new Date(b.receivedDateTime).getTime() - new Date(a.receivedDateTime).getTime());
+            // Apply maxResults limit if specified
+            const maxResults = additionalCriteria.maxResults || 50;
+            const limitedMessages = uniqueMessages.slice(0, maxResults);
+            return {
+                messages: limitedMessages,
+                hasMore: uniqueMessages.length > maxResults || toResults.hasMore || ccResults.hasMore
+            };
+        }
+        catch (error) {
+            logger.error('Error searching emails addressed to me:', error);
+            throw error;
+        }
+    }
 }
 export const ms365Operations = new MS365Operations();

package/package.json

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