get_sent_emails
Retrieve a list of sent emails from your Outlook account to review correspondence or track communications.
Instructions
Get sent emails list
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_sent_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of sent emails to retrieve |
Implementation Reference
- src/outlook-manager.js:487-645 (handler)Core implementation of getSentEmails: Executes PowerShell script to retrieve emails from Outlook Sent Items folder (olFolderSentMail=5), sorts by SentOn, fetches properties like Id, Subject, Sender, Body preview, etc., returns cleaned EmailMessage[]
async getSentEmails(count = 10) { const script = ` function Clean-Text { param([string]$text) if (-not $text) { return "" } # Simple cleaning - remove control characters and normalize whitespace $text = $text -replace '[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]', '' $text = $text -replace '\\r\\n', ' ' $text = $text -replace '\\n', ' ' $text = $text -replace '\\r', ' ' $text = $text -replace '\\t', ' ' $text = $text -replace '\\s+', ' ' return $text.Trim() } try { Add-Type -AssemblyName "Microsoft.Office.Interop.Outlook" -ErrorAction Stop $outlook = New-Object -ComObject Outlook.Application -ErrorAction Stop $namespace = $outlook.GetNamespace("MAPI") $sentItems = $namespace.GetDefaultFolder(5) # 5 = Sent Items folder $itemCount = $sentItems.Items.Count if ($itemCount -eq 0) { Write-Output "[]" exit 0 } $items = $sentItems.Items $items.Sort("[SentOn]", $true) # Sort by sent time instead of received time $emails = @() $counter = 0 foreach ($item in $items) { if ($counter -ge ${count}) { break } try { # Get basic properties safely $rawSubject = if ($item.Subject) { $item.Subject.ToString() } else { "No Subject" } $rawSender = if ($item.SenderEmailAddress) { $item.SenderEmailAddress.ToString() } else { "Unknown" } $rawBody = if ($item.Body) { $bodyStr = $item.Body.ToString() if ($bodyStr.Length -gt 150) { $bodyStr.Substring(0, 150) + "..." } else { $bodyStr } } else { "" } # Clean all text fields $subject = Clean-Text -text $rawSubject $sender = Clean-Text -text $rawSender $bodyText = Clean-Text -text $rawBody $sentTime = if ($item.SentOn) { $item.SentOn.ToString("yyyy-MM-dd HH:mm:ss") } else { (Get-Date).ToString("yyyy-MM-dd HH:mm:ss") } # Create simple email object $email = [PSCustomObject]@{ Id = if ($item.EntryID) { $item.EntryID.ToString() } else { "no-id-$counter" } Subject = $subject Sender = $sender Recipients = @() Body = $bodyText ReceivedTime = $sentTime # Using sent time as received time for consistency IsRead = $true # Sent items are always "read" HasAttachments = $item.Attachments.Count -gt 0 } $emails += $email $counter++ } catch { # Skip problematic emails $counter++ continue } } # Convert to JSON safely if ($emails.Count -eq 0) { Write-Output "[]" } else { try { $jsonResult = $emails | ConvertTo-Json -Depth 2 -Compress Write-Output $jsonResult } catch { # Create safe fallback data $safeEmails = @() for ($i = 0; $i -lt [Math]::Min($emails.Count, 5); $i++) { $safeEmails += [PSCustomObject]@{ Id = "sent-email-$i" Subject = "Sent Email $($i + 1)" Sender = "user@example.com" Recipients = @() Body = "Sent email content available" ReceivedTime = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss") IsRead = $true HasAttachments = $false } } $fallbackJson = $safeEmails | ConvertTo-Json -Depth 2 -Compress Write-Output $fallbackJson } } } catch { $errorResult = [PSCustomObject]@{ error = $_.Exception.Message type = "OutlookConnectionError" } $errorJson = $errorResult | ConvertTo-Json -Compress Write-Output $errorJson } `; try { const result = await this.executePowerShell(script); if (!result || result.trim() === '') { return []; } // Clean result before parsing const cleanResult = result .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '') .trim(); const parsed = JSON.parse(cleanResult); if (parsed.error) { throw new Error(`Outlook Error: ${parsed.error}`); } const emailArray = Array.isArray(parsed) ? parsed : [parsed]; return emailArray.map((item) => ({ id: this.cleanText(item.Id || ''), subject: this.cleanText(item.Subject || 'No Subject'), sender: this.cleanText(item.Sender || 'Unknown'), recipients: [], body: this.cleanText(item.Body || ''), receivedTime: new Date(item.ReceivedTime), isRead: Boolean(item.IsRead), hasAttachments: Boolean(item.HasAttachments) })); } catch (error) { if (error instanceof SyntaxError) { console.error('JSON parse failed, returning fallback emails'); return [{ id: 'fallback-sent-1', subject: 'Sent email content unavailable', sender: 'system@outlook.com', recipients: [], body: 'Unable to retrieve sent email content due to encoding issues.', receivedTime: new Date(), isRead: true, hasAttachments: false }]; } throw new Error(`Failed to get sent emails: ${error instanceof Error ? error.message : String(error)}`); } } - src/index.js:160-173 (registration)Tool registration in ListToolsRequestHandler: defines name, description, and input schema for get_sent_emails tool (optional count parameter)
{ name: "get_sent_emails", description: "获取已发送邮件列表", inputSchema: { type: "object", properties: { count: { type: "number", description: "要获取的已发送邮件数量", default: 10 } } } }, - src/index.js:329-341 (handler)MCP CallToolRequestHandler case for get_sent_emails: calls outlookManager.getSentEmails(count), formats and returns rich text response with email list
case 'get_sent_emails': { const count = args?.count || 10; const emails = await outlookManager.getSentEmails(count); return { content: [ { type: 'text', text: `📊 **邮件总览**\n总计: ${emails.length} 封邮件\n未读: ${emails.filter(e => !e.isRead).length} 封\n\n📋 **邮件列表:**\n` + emails.map((email, index) => `${index + 1}. ${email.isRead ? '✅' : '📩'} **${email.subject}**\n 发件人: ${email.sender}\n 时间: ${email.receivedTime}\n 预览: ${email.body?.substring(0, 100)}...\n`).join('\n') }, ], }; } - src/outlook-manager.ts:220-222 (handler)TypeScript version of getSentEmails handler: delegates to shared getEmailsFromFolder for Sent Items folder
async getSentEmails(count: number = 10): Promise<EmailMessage[]> { return this.getEmailsFromFolder(5, count, "[SentOn]"); // 5 = Sent Items } - src/index.ts:171-182 (registration)TypeScript registration of get_sent_emails tool with English description and input schema
name: "get_sent_emails", description: "Get sent emails list", inputSchema: { type: "object", properties: { count: { type: "number", description: "Number of sent emails to retrieve", default: 10 } } }