dguiducci
955b1ba069
- Aggiunto campo 'title' a tools/list in tutti gli script MCP locali (Gmail, Gcal, Drive, Email, SSH, Weather, Wikipedia, WhatsApp) - Aggiunto tools[]/display_name nel manifest per connector remoti/package esterni (Firecrawl, HTTP Fetch, Exa, Tavily, SerpAPI Flights) - Documentata convenzione e resolution order in SKALD.md - Aggiornata manifest_guide.md per tools[] in connectors.json - Bumped version e sha256 per tutti i 13 connector
131 lines
4.5 KiB
JSON
131 lines
4.5 KiB
JSON
{
|
|
"id": "email",
|
|
"name": "Email (IMAP/SMTP)",
|
|
"type": "mcp_local",
|
|
"launch_command": "python3 email_mcp_server.py",
|
|
"transport": "stdio",
|
|
"requires": [
|
|
"PYTHON"
|
|
],
|
|
"dependencies": [],
|
|
"env": [
|
|
{
|
|
"name": "EMAIL_IMAP_HOST",
|
|
"label": "IMAP host",
|
|
"description": "IMAP server hostname for reading mail (e.g. imap.gmail.com, outlook.office365.com, imap.mail.me.com).",
|
|
"required": true,
|
|
"secret": false,
|
|
"example": "imap.gmail.com"
|
|
},
|
|
{
|
|
"name": "EMAIL_IMAP_PORT",
|
|
"label": "IMAP port",
|
|
"description": "IMAP-over-SSL port. Almost always 993.",
|
|
"required": false,
|
|
"secret": false,
|
|
"default": "993",
|
|
"example": "993"
|
|
},
|
|
{
|
|
"name": "EMAIL_SMTP_HOST",
|
|
"label": "SMTP host",
|
|
"description": "SMTP server hostname for sending mail (e.g. smtp.gmail.com, smtp.office365.com, smtp.mail.me.com).",
|
|
"required": true,
|
|
"secret": false,
|
|
"example": "smtp.gmail.com"
|
|
},
|
|
{
|
|
"name": "EMAIL_SMTP_PORT",
|
|
"label": "SMTP port",
|
|
"description": "SMTP port: 465 for implicit SSL, 587 for STARTTLS.",
|
|
"required": false,
|
|
"secret": false,
|
|
"default": "465",
|
|
"example": "465"
|
|
},
|
|
{
|
|
"name": "EMAIL_SMTP_SECURITY",
|
|
"label": "SMTP security",
|
|
"description": "How to secure the SMTP connection: 'ssl' (port 465), 'starttls' (port 587), or 'plain'. If omitted, inferred from the port.",
|
|
"required": false,
|
|
"secret": false,
|
|
"default": "ssl",
|
|
"example": "ssl"
|
|
},
|
|
{
|
|
"name": "EMAIL_USERNAME",
|
|
"label": "Username / email address",
|
|
"description": "Login username, usually the full email address.",
|
|
"required": true,
|
|
"secret": false,
|
|
"example": "me@example.com"
|
|
},
|
|
{
|
|
"name": "EMAIL_PASSWORD",
|
|
"label": "Password / app password",
|
|
"description": "Account password. Providers with 2FA (Gmail, iCloud, Yahoo, Outlook) require an app-specific password, not your normal login password.",
|
|
"required": true,
|
|
"secret": true,
|
|
"example": "abcd efgh ijkl mnop"
|
|
},
|
|
{
|
|
"name": "EMAIL_FROM",
|
|
"label": "From address",
|
|
"description": "Address to put in the From header when sending. Defaults to the username if omitted.",
|
|
"required": false,
|
|
"secret": false,
|
|
"example": "me@example.com"
|
|
}
|
|
],
|
|
"setup_instructions": [
|
|
"No files on disk and no OAuth: configuration is entirely via environment variables.",
|
|
"Set EMAIL_IMAP_HOST, EMAIL_SMTP_HOST, EMAIL_USERNAME and EMAIL_PASSWORD (required).",
|
|
"For providers with 2FA (Gmail, iCloud, Yahoo, Outlook), generate an app-specific password and use it as EMAIL_PASSWORD.",
|
|
"Optionally set EMAIL_IMAP_PORT (993), EMAIL_SMTP_PORT (465/587), EMAIL_SMTP_SECURITY (ssl/starttls) and EMAIL_FROM.",
|
|
"Run the 'status' tool to verify IMAP and SMTP both authenticate."
|
|
],
|
|
"docs": [
|
|
{
|
|
"lang": "en",
|
|
"description": "Generic email connector over IMAP + SMTP. Works with any provider (Gmail, Outlook/Office 365, iCloud, Yahoo, Fastmail, self-hosted, corporate) using standard protocols and an app password \u2014 no Google Cloud Console, no OAuth. Read, search, organise and send mail, download attachments, and receive real-time push notifications when new mail arrives (IMAP IDLE, with polling fallback). Standard library only, zero dependencies.",
|
|
"llm_short_description": "Email MCP server (IMAP/SMTP, any provider). Config via env vars. Tools: status, list_messages, get_message, get_thread, list_folders, modify_message, send_message, get_profile, create_folder, download_attachments. Emits event/new_email push notifications on new INBOX mail."
|
|
}
|
|
],
|
|
"mcp_config": {
|
|
"command": "python3",
|
|
"args": [
|
|
"email_mcp_server.py"
|
|
],
|
|
"env": {
|
|
"EMAIL_IMAP_HOST": "{ENV:EMAIL_IMAP_HOST}",
|
|
"EMAIL_IMAP_PORT": "{ENV:EMAIL_IMAP_PORT}",
|
|
"EMAIL_SMTP_HOST": "{ENV:EMAIL_SMTP_HOST}",
|
|
"EMAIL_SMTP_PORT": "{ENV:EMAIL_SMTP_PORT}",
|
|
"EMAIL_SMTP_SECURITY": "{ENV:EMAIL_SMTP_SECURITY}",
|
|
"EMAIL_USERNAME": "{ENV:EMAIL_USERNAME}",
|
|
"EMAIL_PASSWORD": "{SECRET:EMAIL_PASSWORD}",
|
|
"EMAIL_FROM": "{ENV:EMAIL_FROM}"
|
|
}
|
|
},
|
|
"verify": {
|
|
"command": "python3 verify.py",
|
|
"timeout_secs": 20
|
|
},
|
|
"homepage": "",
|
|
"icon_small": "icon_sm.svg",
|
|
"icon_large": "icon_lg.svg",
|
|
"scope": "user",
|
|
"tags": [
|
|
"email",
|
|
"mcp",
|
|
"local",
|
|
"imap",
|
|
"smtp"
|
|
],
|
|
"auth": {
|
|
"type": "password"
|
|
},
|
|
"version": 2,
|
|
"version_string": "1.0.1",
|
|
"version_release_date": "2026-07-21"
|
|
} |