c1ced5a4dfd3cdbf1130225a2c8799323adbff52source_git · jtokib/yahoo-mail-mcp-server · current release
Observed 2026-08-25T09:01:28.532Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.
{
"tools": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
archive_emailsMove emails to Archive folder using UIDs for long-term storage. UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to archive",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Source folder (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
delete_emailsMove emails to Trash folder using UIDs (soft delete, recoverable). UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to delete",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Source folder (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
flag_emailsFlag emails as important/starred using UIDs. UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to flag",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Folder containing emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
list_emailsList recent emails from a Yahoo Mail folder. Returns UIDs (permanent identifiers) and enriched metadata including size, flags, and attachment status.Input schema{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of emails to retrieve (default: 10, max: 50)",
"default": 10
},
"folder": {
"type": "string",
"description": "Folder to list emails from (default: INBOX). Use list_folders to see available folders.",
"default": "INBOX"
},
"offset": {
"type": "number",
"description": "Number of emails to skip (for pagination, default: 0)",
"default": 0
}
}
} | — | — · — | — |
list_foldersList all available IMAP folders/mailboxes in your Yahoo Mail accountInput schema{
"type": "object",
"properties": {}
} | — | — · — | — |
mark_as_readMark emails as read using UIDs. UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to mark as read",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Folder containing emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
mark_as_unreadMark emails as unread using UIDs. UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to mark as unread",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Folder containing emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
move_emailsMove emails to a specified folder using UIDs. UIDs are permanent identifiers. Use list_folders to see available folders.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to move",
"minItems": 1
},
"folderName": {
"type": "string",
"description": "Name of the destination folder (e.g., \"Work\", \"Personal\"). Use list_folders to see available folders."
},
"sourceFolder": {
"type": "string",
"description": "Source folder containing the emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids",
"folderName"
]
} | — | — · — | — |
read_emailRead email content using UIDs (permanent identifiers). UIDs don't change when emails are deleted. Get UIDs from list_emails or search_emails.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to read. UIDs are permanent identifiers from list_emails.",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Folder containing the emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |
search_emailsSearch emails using UIDs with advanced filters. Returns UIDs which are permanent identifiers that don't change when emails are deleted. Get UIDs from results for subsequent operations.Input schema{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search term for subject or sender (can be empty for date-only searches)",
"default": ""
},
"count": {
"type": "number",
"description": "Number of results to return (default: 10, max: 50)",
"default": 10
},
"dateFrom": {
"type": "string",
"description": "Filter emails from this date onwards (ISO 8601 or RFC 2822 format)",
"default": null
},
"dateTo": {
"type": "string",
"description": "Filter emails up to this date (ISO 8601 or RFC 2822 format)",
"default": null
},
"sender": {
"type": "string",
"description": "Filter by specific sender email address or name",
"default": null
},
"unreadOnly": {
"type": "boolean",
"description": "Only return unread emails (default: false)",
"default": false
},
"folder": {
"type": "string",
"description": "Folder to search in (default: INBOX). Use list_folders to see available folders.",
"default": "INBOX"
}
},
"required": []
} | — | — · — | — |
unflag_emailsRemove flag/star from emails using UIDs. UIDs are permanent identifiers.Input schema{
"type": "object",
"properties": {
"uids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Array of UIDs to unflag",
"minItems": 1
},
"folder": {
"type": "string",
"description": "Folder containing emails (default: INBOX)",
"default": "INBOX"
}
},
"required": [
"uids"
]
} | — | — · — | — |