{"_id":"@adam-gfam/imap-server","_rev":"5-d44fc08dfd806197a91c9d3159649943","name":"@adam-gfam/imap-server","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@adam-gfam/imap-server","version":"0.1.0","_id":"@adam-gfam/imap-server@0.1.0","maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"bin":{"imap-server":"dist/index.js"},"dist":{"shasum":"1bd877f2a2a22528a88ad55706d162b21227be0d","tarball":"https://registry.npmjs.org/@adam-gfam/imap-server/-/imap-server-0.1.0.tgz","fileCount":82,"integrity":"sha512-WoStiMbqSEvNJx4MImlC9HINtbPFPMiY7uXLw1PJwFFlQSLwNQRj6AZsaAhNG5N46zbeb0Y2taoY+CJaFaamMQ==","signatures":[{"sig":"MEUCIQCMC5u/w4ybQkrsuGdkT5N9Yod+TV5Ri+KHmanpQGgmjgIgP8IwNjTmmjE9E+Z0h9O0mEgX8ucM5d69Nu9bvY2ZEe0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":176125},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"af69bb550975ddaa4af8dfcf8d2fc151d534b6a4","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"adam-gfam","email":"adam.giunta916@gmail.com"},"_npmVersion":"11.17.0","description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","directories":{},"_nodeVersion":"26.5.1","dependencies":{"zod":"^4.0.0","dotenv":"^17.0.0","imapflow":"^1.7.0","mailparser":"^3.9.0","nodemailer":"^9.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^22.0.0","@types/nodemailer":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/imap-server_0.1.0_1788188564101_0.0956186786668316","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@adam-gfam/imap-server","version":"0.1.1","_id":"@adam-gfam/imap-server@0.1.1","maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"bin":{"imap-server":"dist/index.js"},"dist":{"shasum":"8e946813d735688e32476f3eb869217dbe0f19e6","tarball":"https://registry.npmjs.org/@adam-gfam/imap-server/-/imap-server-0.1.1.tgz","fileCount":22,"integrity":"sha512-cF3Ou6cI8953g+NK1SalDDx/wNjbwXdDvj5FqJjLvbIn0iTkunm2eMQ9UV2r/d4VNAjCgtrYZhEcaRmLnWgJog==","signatures":[{"sig":"MEUCIFTgCzeewFn/vNow0q/qKbJrlWxgaCl70vfCcic5D7yeAiEA8hv1BO4hLm/joOAvUtpSE0ZJHnLZvU0cQJU49uceRY8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61013},"main":"dist/index.js","type":"module","gitHead":"96f8cd3048e0a2220710f1ac6b864cc0833141f9","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"adam-gfam","email":"adam.giunta916@gmail.com"},"_npmVersion":"12.0.2","description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","directories":{},"_nodeVersion":"24.19.0","allowScripts":{"esbuild@0.28.2":true},"dependencies":{"zod":"^4.0.0","dotenv":"^17.0.0","imapflow":"^1.7.0","mailparser":"^3.9.0","nodemailer":"^9.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^22.0.0","@types/nodemailer":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/imap-server_0.1.1_1788240330994_0.4318780744047226","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@adam-gfam/imap-server","version":"0.1.2","_id":"@adam-gfam/imap-server@0.1.2","maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"bin":{"imap-server":"dist/index.js"},"dist":{"shasum":"07b7bbd5090e6d4e342e8167b7e554305888ffb3","tarball":"https://registry.npmjs.org/@adam-gfam/imap-server/-/imap-server-0.1.2.tgz","fileCount":82,"integrity":"sha512-jkJjpHWKIves1G35HJanbg9Z+ynvXeDua0wSa6GwAecemgrNYYUmESWg4aNiBivWQj2kb9kZknaMo6RcQpDWKA==","signatures":[{"sig":"MEQCIEIR26d04bc8cp8n0pIMbk8DKjk0ihsC2+Z4IxI2qjgnAiA7+WRFBlRhwt5L7xfz0wFx3NU3277tbwsOtygVlTo4YQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":178461},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"6fab9de6aa135489bae345079373eeabfdb45875","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"adam-gfam","email":"adam.giunta916@gmail.com"},"_npmVersion":"12.0.2","description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","directories":{},"_nodeVersion":"24.19.0","allowScripts":{"esbuild@0.28.2":true},"dependencies":{"zod":"^4.0.0","dotenv":"^17.0.0","imapflow":"^1.7.0","mailparser":"^3.9.0","nodemailer":"^9.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^22.0.0","@types/nodemailer":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/imap-server_0.1.2_1788265726573_0.03187332900738893","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@adam-gfam/imap-server","version":"0.1.3","_id":"@adam-gfam/imap-server@0.1.3","maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"bin":{"imap-server":"dist/index.js"},"dist":{"shasum":"72bffabe98f549242432c4fceda3a4e8766aa55a","tarball":"https://registry.npmjs.org/@adam-gfam/imap-server/-/imap-server-0.1.3.tgz","fileCount":85,"integrity":"sha512-crfpJ4vp8tv2CMHGbOkXv8EpUAvUxTogxWbAYW2r7pZtlNUz4L8TCvReCeuVSziG77+dUTIIMdsUy9oV8dP6vA==","signatures":[{"sig":"MEUCIHTZuHt1U6imTwL1RsS2FB21bxXEWxAr3riEUZukvgl5AiEAzNVhXMnEG8GUBe3YaolyuVHOGtIQsyfLAZ8rhjbTiGs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":177475},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"32ee12cb2872c33f6011871d7b3bd2072359d09e","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"adam-gfam","email":"adam.giunta916@gmail.com"},"_npmVersion":"12.0.2","description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.0.0","dotenv":"^17.0.0","imapflow":"^1.7.0","mailparser":"^3.9.0","nodemailer":"^9.0.0","node-html-markdown":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^22.0.0","@types/nodemailer":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/imap-server_0.1.3_1788500815382_0.592832702884933","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@adam-gfam/imap-server","version":"0.1.4","type":"module","description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","main":"dist/index.js","bin":{"imap-server":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts"},"dependencies":{"@modelcontextprotocol/server":"^2.0.0","dotenv":"^17.0.0","imapflow":"^1.7.0","mailparser":"^3.9.0","node-html-markdown":"^2.0.0","nodemailer":"^9.0.0","zod":"^4.0.0"},"devDependencies":{"@types/node":"^22.0.0","@types/nodemailer":"^8.0.0","tsx":"^4.19.0","typescript":"^5.5.0"},"gitHead":"a6a4c74e18ae93594ffb3548ceb6a075b047475c","types":"./dist/index.d.ts","_id":"@adam-gfam/imap-server@0.1.4","_nodeVersion":"24.19.0","_npmVersion":"12.0.2","dist":{"integrity":"sha512-j2ihvHMEatH2FHaY2CwhWa3eUFtx/okmzGK4y8fywpkDejoifYwn6vI74p/MxYTOsTDt9SV8KklPjKj+eKYyeA==","shasum":"ddb07e9a01e2d4552c60b6272a5126d57c6a9b23","tarball":"https://registry.npmjs.org/@adam-gfam/imap-server/-/imap-server-0.1.4.tgz","fileCount":85,"unpackedSize":178108,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCqyeN/ykJ3okucHWjRW7pSFp1lrXQ6KGH24mkh0xnjSwIhAKbq8Sgf8hlGFAHwlAkEHaDHUmv1qXTRedFmwvPf+dBE"}]},"_npmUser":{"name":"adam-gfam","email":"adam.giunta916@gmail.com"},"directories":{},"maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/imap-server_0.1.4_1788926809535_0.12157161076517387"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-31T15:02:43.958Z","modified":"2026-09-09T04:06:49.822Z","0.1.0":"2026-08-31T15:02:44.236Z","0.1.1":"2026-09-01T05:25:31.125Z","0.1.2":"2026-09-01T12:28:46.696Z","0.1.3":"2026-09-04T05:46:55.555Z","0.1.4":"2026-09-09T04:06:49.665Z"},"description":"IMAP/SMTP MCP Server - email operations via Model Context Protocol","maintainers":[{"name":"adam-gfam","email":"adam.giunta916@gmail.com"}],"readme":"# Simple IMAP MCP Server\n\nA Node.js IMAP/SMTP MCP server that provides email operations via the Model Context Protocol.\n\n## Quick Start\n\n```bash\n# Install and run locally\nnpm install @adam-gfam/imap-server\n\n# OR run without installing\nnpx -y @adam-gfam/imap-server\n```\n\n## Configuration\n\nCopy `.env.example` to `.env` and fill in your IMAP/SMTP credentials. See the full [Configuration Guide](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2/Configuration%20Guide) for details.\n\n## Usage\n\nOnce the server is running, it exposes the following tools, resources, and prompts via the MCP protocol.\n\n### Transport Modes\n\n| Mode | Use Case | Configuration |\n|------|----------|---------------|\n| stdio | Claude Desktop, CLI tools, local agents | Default, no config needed |\n| Streamable HTTP | Remote LLM clients, web dashboards | `MCP_TRANSPORT=http`, `HTTP_PORT=3000` |\n\n### IMAP Tools\n\n- **list_folders** — List all IMAP mailboxes/folders. Parameters: `folder_pattern`, `include_subfolders`.\n- **search_emails** — Search emails by criteria (folder, from, to, subject, date, keyword, unread_only). Paginated results.\n- **fetch_email** — Fetch full email content including headers, body, and attachments by UID.\n- **get_email_body** — Fast body-only fetch (text and/or HTML) for a given UID.\n- **get_email_headers** — Minimal-bandwidth header fetch without downloading the body.\n- **mark_as_read** — Toggle read/unread status via IMAP FLAGS.\n- **move_email** — Move an email to a different IMAP folder (creates destination if needed).\n- **delete_email** — Delete an email (moves to Trash).\n- **create_folder** — Create a new IMAP mailbox folder (supports hierarchy like `\"Work/Projects\"`).\n- **list_unread** — Quick listing of unread messages with pagination.\n\n### SMTP Tools\n\n- **send_email** — Send an email with text or HTML body. Supports `to`, `subject`, `body`, `html`, `from`, `cc`, `bcc`.\n- **send_email_with_attachment** — Send an email with file attachments (`[{ name, content (base64), content_type }]`).\n- **list_drafts** — List draft emails in the Drafts folder.\n- **save_as_draft** — Save an email as a draft (plain text or HTML).\n- **delete_draft** — Delete a draft email by UID.\n\n### MCP Resources\n\n| Resource | Description | URI Template |\n|----------|-------------|-------------|\n| email_body | Parsed email body text | `email://<folder>/<uid>/body` |\n| email_headers | Email headers | `email://<folder>/<uid>/headers` |\n\n### MCP Prompts\n\n| Prompt | Description | Arguments |\n|--------|-------------|-----------|\n| search_emails | \"Help me search my emails\" | query, date_range, folder |\n| compose_reply | \"Draft a reply to this email\" | email_uid, tone |\n| organize_inbox | \"Help me organize my inbox\" | criteria, folder |\n\n## Documentation\n\nAll project documentation is hosted in the [Simple IMAP MCP Project collective](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2):\n\n- [Project Overview](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2/Project%20Overview) — Architecture, tech stack, project structure\n- [API Reference](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2/API%20Reference) — Complete tool and resource API docs\n- [Source Code Index](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2/Source%20Code%20Index) — Source file inventory\n- [Configuration Guide](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2/Configuration%20Guide) — Env vars, installation, setup\n\n## Contributing\n\n**All future design and technical documents must be created directly in the [Nextcloud collective](https://our.gfam.my.id/apps/collectives/p/MGwd9JDeJ9wGDzS/Simple-IMAP-MCP-Project-2), not locally.** The collective is the single source of truth for all project documentation.\n\n## Tech Stack\n\n- MCP Server: `@modelcontextprotocol/server` v2\n- IMAP: `imapflow` v1.7\n- SMTP: `nodemailer` v9\n- MIME Parser: `mailparser` v3.9\n- Schema: `zod` v4\n- Env: `dotenv` v17\n","readmeFilename":"README.md"}