read_inbox
ActiveTool of EmailMCP
declared in 1.0.0
Read emails from an inbox via IMAP with filtering options. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account (work, personal, etc.).
Parameters schema
{
"type": "object",
"properties": {
"filter": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Filter by recipient email address"
},
"from": {
"type": "string",
"description": "Filter by sender email address"
},
"limit": {
"type": "number",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of emails to read"
},
"since": {
"type": "string",
"format": "date",
"description": "Only emails after this date (YYYY-MM-DD)"
},
"before": {
"type": "string",
"format": "date",
"description": "Only emails before this date (YYYY-MM-DD)"
},
"flagged": {
"type": "boolean",
"description": "Only return flagged emails"
},
"mailbox": {
"type": "string",
"default": "INBOX",
"description": "Mailbox to read from"
},
"unread_only": {
"type": "boolean",
"default": false,
"description": "Only return unread emails"
},
"body_contains": {
"type": "string",
"description": "Filter by text in email body"
},
"subject_contains": {
"type": "string",
"description": "Filter by text in subject line"
}
}
},
"account": {
"type": "string",
"optional": true,
"description": "Named account to read from (e.g. \"work\", \"personal\"). Omit for default account."
},
"options": {
"type": "object",
"properties": {
"include_body": {
"type": "boolean",
"default": true,
"description": "Include email body content"
},
"mark_as_read": {
"type": "boolean",
"default": false,
"description": "Mark emails as read after fetching"
},
"include_attachments": {
"type": "boolean",
"default": false,
"description": "Include attachment information"
}
}
},
"imap_config": {
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "IMAP server hostname (e.g., imap.gmail.com)"
},
"port": {
"type": "number",
"default": 993,
"description": "IMAP server port (default: 993 for SSL)"
},
"email": {
"type": "string",
"description": "Email address for authentication"
},
"secure": {
"type": "boolean",
"default": true,
"description": "Use SSL/TLS connection"
},
"password": {
"type": "string",
"description": "Password or app-specific password"
}
},
"description": "Optional if IMAP is configured in .env (IMAP_HOST, IMAP_EMAIL, IMAP_PASSWORD)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
EmailMCP
https://github.com/nfodor/emailmcp
1/7 registries