ms365-mcp-server 1.1.0 → 1.1.1

package/README.md

@@ -16,7 +16,7 @@ A powerful **Model Context Protocol (MCP) server** that enables seamless Microso
 
 ### **📧 Email Management**
 - **`send_email`** - Send emails with attachments and rich formatting
-- **`manage_email`** - **UNIFIED**: Read, search, list, mark, move, or delete emails
+- **`manage_email`** - **UNIFIED**: Read, search, list, mark, move, delete, or draft emails
 - **`get_attachment`** - Download email attachments with metadata
 - **`list_folders`** - Browse mailbox folders with item counts
 
@@ -200,6 +200,20 @@ ms365-mcp-server --login
     "messageId": "email_id"
   }
 }
+
+// Create draft email
+{
+  "tool": "manage_email",
+  "arguments": {
+    "action": "draft",
+    "draftTo": ["colleague@company.com"],
+    "draftSubject": "Draft: Project Update",
+    "draftBody": "<h2>Status Report</h2><p>Project is on track!</p>",
+    "draftBodyType": "html",
+    "draftCc": ["manager@company.com"],
+    "draftImportance": "normal"
+  }
+}
 ```
 
 ### Contact & Authentication

package/dist/index.js

@@ -55,7 +55,7 @@ function parseArgs() {
 }
 const server = new Server({
     name: "ms365-mcp-server",
-    version: "1.1.0"
+    version: "1.1.1"
 }, {
     capabilities: {
         resources: {
@@ -183,8 +183,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     },
                     action: {
                         type: "string",
-                        enum: ["read", "search", "list", "mark", "move", "delete", "search_to_me"],
-                        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)"
+                        enum: ["read", "search", "list", "mark", "move", "delete", "search_to_me", "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/save draft)"
                     },
                     messageId: {
                         type: "string",
@@ -259,6 +259,64 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         minimum: 1,
                         maximum: 200,
                         default: 50
+                    },
+                    // Draft email parameters
+                    draftTo: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "List of recipient email addresses (required for draft action)"
+                    },
+                    draftCc: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "List of CC recipient email addresses (optional for draft action)"
+                    },
+                    draftBcc: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "List of BCC recipient email addresses (optional for draft action)"
+                    },
+                    draftSubject: {
+                        type: "string",
+                        description: "Email subject line (required for draft action)"
+                    },
+                    draftBody: {
+                        type: "string",
+                        description: "Email content (required for draft action)"
+                    },
+                    draftBodyType: {
+                        type: "string",
+                        enum: ["text", "html"],
+                        description: "Content type of the email body for draft (default: text)",
+                        default: "text"
+                    },
+                    draftImportance: {
+                        type: "string",
+                        enum: ["low", "normal", "high"],
+                        description: "Email importance level for draft (default: normal)",
+                        default: "normal"
+                    },
+                    draftAttachments: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                name: {
+                                    type: "string",
+                                    description: "Name of the attachment file"
+                                },
+                                contentBytes: {
+                                    type: "string",
+                                    description: "Base64 encoded content of the attachment"
+                                },
+                                contentType: {
+                                    type: "string",
+                                    description: "MIME type of the attachment (optional, auto-detected if not provided)"
+                                }
+                            },
+                            required: ["name", "contentBytes"]
+                        },
+                        description: "List of email attachments for draft (optional)"
                     }
                 },
                 required: ["action"],
@@ -653,6 +711,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 }
                             ]
                         };
+                    case "draft":
+                        if (!args?.draftTo || !args?.draftSubject || !args?.draftBody) {
+                            throw new Error("draftTo, draftSubject, and draftBody are required for draft action");
+                        }
+                        const draftResult = await ms365Ops.saveDraftEmail({
+                            to: args.draftTo,
+                            cc: args.draftCc,
+                            bcc: args.draftBcc,
+                            subject: args.draftSubject,
+                            body: args.draftBody,
+                            bodyType: args.draftBodyType || 'text',
+                            importance: args.draftImportance || 'normal',
+                            attachments: args.draftAttachments
+                        });
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `✅ Draft email saved successfully!\n📧 Subject: ${args.draftSubject}\n👥 To: ${Array.isArray(args.draftTo) ? args.draftTo.join(', ') : args.draftTo}\n🆔 Draft ID: ${draftResult.id}`
+                                }
+                            ]
+                        };
                     default:
                         throw new Error(`Unknown email action: ${emailAction}`);
                 }

package/dist/utils/ms365-operations.js

@@ -244,6 +244,74 @@ export class MS365Operations {
             throw error;
         }
     }
+    /**
+     * Save a draft email
+     */
+    async saveDraftEmail(message) {
+        try {
+            const graphClient = await this.getGraphClient();
+            // Prepare recipients
+            const toRecipients = message.to.map(email => ({
+                emailAddress: {
+                    address: email,
+                    name: email.split('@')[0]
+                }
+            }));
+            const ccRecipients = message.cc?.map(email => ({
+                emailAddress: {
+                    address: email,
+                    name: email.split('@')[0]
+                }
+            })) || [];
+            const bccRecipients = message.bcc?.map(email => ({
+                emailAddress: {
+                    address: email,
+                    name: email.split('@')[0]
+                }
+            })) || [];
+            // Prepare attachments
+            const attachments = message.attachments?.map(att => ({
+                '@odata.type': '#microsoft.graph.fileAttachment',
+                name: att.name,
+                contentBytes: att.contentBytes,
+                contentType: att.contentType || 'application/octet-stream'
+            })) || [];
+            // Prepare draft email body
+            const draftBody = {
+                subject: message.subject,
+                body: {
+                    contentType: message.bodyType === 'html' ? 'html' : 'text',
+                    content: message.body || ''
+                },
+                toRecipients,
+                ccRecipients,
+                bccRecipients,
+                importance: message.importance || 'normal',
+                attachments: attachments.length > 0 ? attachments : undefined
+            };
+            if (message.replyTo) {
+                draftBody.replyTo = [{
+                        emailAddress: {
+                            address: message.replyTo,
+                            name: message.replyTo.split('@')[0]
+                        }
+                    }];
+            }
+            // Save draft email
+            const result = await graphClient
+                .api('/me/messages')
+                .post(draftBody);
+            logger.log('Draft email saved successfully');
+            return {
+                id: result.id,
+                status: 'draft'
+            };
+        }
+        catch (error) {
+            logger.error('Error saving draft email:', error);
+            throw error;
+        }
+    }
     /**
      * Get email by ID
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms365-mcp-server",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "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",
@@ -55,4 +55,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-} 
+}