# Send IMAP Email Reader to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "imap-email", "name": "IMAP Email Reader", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/mvarrieur/imap-email", "canonicalUrl": "https://clawhub.ai/mvarrieur/imap-email", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/imap-email", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=imap-email", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "package-lock.json", "package.json", "scripts/imap.js", "setup.sh", "skill.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "imap-email", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T04:50:47.079Z", "expiresAt": "2026-05-07T04:50:47.079Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=imap-email", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=imap-email", "contentDisposition": "attachment; filename=\"imap-email-1.0.3.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "imap-email" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/imap-email" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/imap-email", "downloadUrl": "https://openagent3.xyz/downloads/imap-email", "agentUrl": "https://openagent3.xyz/skills/imap-email/agent", "manifestUrl": "https://openagent3.xyz/skills/imap-email/agent.json", "briefUrl": "https://openagent3.xyz/skills/imap-email/agent.md" } } ``` ## Documentation ### IMAP Email Reader Read, search, and manage email via IMAP protocol. Supports ProtonMail Bridge, Gmail IMAP, and any standard IMAP server. ### Quick Start Check for new emails: node skills/imap-email/scripts/imap.js check Fetch specific email: node skills/imap-email/scripts/imap.js fetch Mark as read: node skills/imap-email/scripts/imap.js mark-read Search mailbox: node skills/imap-email/scripts/imap.js search --from "sender@example.com" --unseen ### Configuration Quick setup (ProtonMail Bridge): cd skills/imap-email ./setup.sh The setup helper will prompt for Bridge credentials and test the connection. Manual setup: Copy .env.example to .env in the skill folder Fill in your IMAP credentials The .env file is automatically ignored by git Environment variables: IMAP_HOST=127.0.0.1 # Server hostname IMAP_PORT=1143 # Server port IMAP_USER=your@email.com IMAP_PASS=your_password IMAP_TLS=false # Use TLS/SSL connection IMAP_REJECT_UNAUTHORIZED=false # Set to false for self-signed certs (optional) IMAP_MAILBOX=INBOX # Default mailbox ⚠️ Security: Never commit your .env file! It's already in .gitignore to prevent accidents. ProtonMail Bridge setup: Install and run ProtonMail Bridge Use 127.0.0.1:1143 for IMAP Password is generated by Bridge (not your ProtonMail password) TLS: Use false (Bridge uses STARTTLS) REJECT_UNAUTHORIZED: Set to false (Bridge uses self-signed cert) Gmail IMAP setup: Host: imap.gmail.com Port: 993 TLS: true Enable "Less secure app access" or use App Password REJECT_UNAUTHORIZED: Omit or set to true (default) ### check Check for unread/new emails in mailbox. node scripts/imap.js check [--limit 10] [--mailbox INBOX] [--recent 2h] Options: --limit : Max results (default: 10) --mailbox : Mailbox to check (default: INBOX) --recent