Outlook MCP Server

Instructions

Implementation Reference

• src/outlook-manager.ts:392-474 (handler)

  The core handler function that duplicates an existing email as a new draft in Outlook. It uses PowerShell to invoke Outlook COM API, finds the source email by ID, creates a ReplyAll copy to preserve formatting, updates subject and recipients if provided, and saves it as a draft.

  async duplicateEmailAsDraft(sourceEmailId: string, newSubject?: string, newRecipients?: string[], storeId?: string): Promise<string> {
    const script = `
      try {
        Add-Type -AssemblyName "Microsoft.Office.Interop.Outlook" -ErrorAction Stop
        $outlook = New-Object -ComObject Outlook.Application -ErrorAction Stop
        $namespace = $outlook.GetNamespace("MAPI")
        
        # Find the original email using EntryID and StoreID
        $item = $null
        $sourceEntryID = "${sourceEmailId.replace(/"/g, '""')}"
        $sourceStoreID = "${(storeId || '').replace(/"/g, '""')}"
        
        # Try GetItemFromID with StoreID first, then fallback methods
        try {
          if ($sourceStoreID -and $sourceStoreID.Length -gt 0) {
            $item = $namespace.GetItemFromID($sourceEntryID, $sourceStoreID)
          } else {
            $item = $namespace.GetItemFromID($sourceEntryID)
          }
        } catch {
          # Fallback: search through folders
          $folders = @(
            $namespace.GetDefaultFolder(6),  # Inbox
            $namespace.GetDefaultFolder(5),  # Sent Items
            $namespace.GetDefaultFolder(16)  # Drafts
          )
          
          foreach ($folder in $folders) {
            try {
              foreach ($email in $folder.Items) {
                if ($email.EntryID -eq $sourceEntryID) {
                  $item = $email
                  break
                }
              }
              if ($item) { break }
            } catch { continue }
          }
        }
        
        if (-not $item) {
          throw "Original email not found with EntryID: $sourceEntryID"
        }
        
        # Use ReplyAll to preserve all formatting, then modify
        $draft = $item.ReplyAll()
        
        # Update subject if provided
        $subjectToUse = "${(newSubject || '').replace(/"/g, '""')}"
        if ($subjectToUse.Length -gt 0) {
          $draft.Subject = $subjectToUse
        }
        
        # Clear and set recipients if provided
        if ("${(newRecipients || []).join(',')}" -ne "") {
          $draft.Recipients.RemoveAll()
          $newRecipientsList = @("${(newRecipients || []).join('","')}")
          foreach ($recipient in $newRecipientsList) {
            if ($recipient.Trim().Length -gt 0) {
              $draft.Recipients.Add($recipient.Trim()) | Out-Null
            }
          }
        }
        
        # Resolve recipients and save
        try {
          $draft.Recipients.ResolveAll() | Out-Null
        } catch { }
        
        $draft.Save()
        Write-Output "success"
        
      } catch {
        Write-Output "error: $($_.Exception.Message)"
      }
    `;
    
    const result = await this.executePowerShell(script);
    if (result.startsWith('error:')) {
      throw new Error(result.substring(7));
    }
    return 'Draft created successfully using ReplyAll method';
  }

• src/index.ts:218-242 (schema)

  Input schema definition for the duplicate_email_as_draft tool, specifying parameters like source_email_id (required), store_id, new_subject, and new_recipients.

  name: "duplicate_email_as_draft",
  description: "Duplicate existing email as draft (preserving complete format)",
  inputSchema: {
    type: "object",
    properties: {
      source_email_id: {
        type: "string",
        description: "Original email ID to duplicate"
      },
      store_id: {
        type: "string",
        description: "Store ID for the original email (optional but recommended)"
      },
      new_subject: {
        type: "string",
        description: "New email subject (optional)"
      },
      new_recipients: {
        type: "array",
        items: { type: "string" },
        description: "New recipient list (optional)"
      }
    },
    required: ["source_email_id"]
  }

• src/index.ts:659-683 (registration)

  Tool registration in the CallToolRequestSchema handler switch statement. Extracts arguments, validates source_email_id, calls the OutlookManager.duplicateEmailAsDraft method, and formats the response.

  case 'duplicate_email_as_draft': {
    const sourceEmailId = (args as any)?.source_email_id;
    const newSubject = (args as any)?.new_subject;
    const newRecipients = (args as any)?.new_recipients;
    const storeId = (args as any)?.store_id;
    
    if (!sourceEmailId) {
      throw new Error('Source email ID is required');
    }
    
    const result = await outlookManager.duplicateEmailAsDraft(
      sourceEmailId,
      newSubject,
      newRecipients,
      storeId
    );
    return {
      content: [
        {
          type: 'text',
          text: `✅ **Email duplicated successfully**\n\n**Result:** ${result}${newSubject ? `\n**New Subject:** ${newSubject}` : ''}${newRecipients ? `\n**New Recipients:** ${newRecipients.join(', ')}` : ''}`,
        },
      ],
    };
  }

• src/index.js:175-196 (registration)

  Alternative registration and schema in the JavaScript version of index.js for list tools.

      name: "duplicate_email_as_draft",
      description: "复制已有邮件为草稿（保持完整格式）",
      inputSchema: {
          type: "object",
          properties: {
              source_email_id: {
                  type: "string",
                  description: "要复制的原始邮件ID"
              },
              new_subject: {
                  type: "string",
                  description: "新邮件主题（可选）"
              },
              new_recipients: {
                  type: "array",
                  items: { type: "string" },
                  description: "新收件人列表（可选）"
              }
          },
          required: ["source_email_id"]
      }
  }