emailmd
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
Local IMAP/SMTP email MCP server: 61 tools, safe Sieve filter rules, read-only mode, multi-account.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Imap Wizard. Follow https://mcp.popnx.com/i/fe2-o3-imap-wizard.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 18, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Imap Wizard for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "imap-wizard": { "command": "npx", "args": [ "-y", "imap-wizard" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Imap Wizard tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"imap-wizard": {
"command": "npx",
"args": [
"-y",
"imap-wizard"
]
}
}
}Use Imap Wizard and tell me what you can do for me, then show me one thing✓ If Claude says it is using Imap Wizard or shows a Imap Wizard tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Imap Wizard yet
Imap Wizard runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Imap Wizard
B · Others in Chat & email that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Imap Wizard for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user imap-wizard -- npx -y imap-wizard 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Imap Wizard tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user imap-wizard -- npx -y imap-wizardYou should see Imap Wizard listed as connected
Use Imap Wizard and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Imap Wizard or shows a Imap Wizard tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Imap Wizard for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "imap-wizard": { "command": "npx", "args": [ "-y", "imap-wizard" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Imap Wizard tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use Imap Wizard and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Imap Wizard or shows a Imap Wizard tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Imap Wizard for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "imap-wizard": { "type": "stdio", "command": "npx", "args": [ "-y", "imap-wizard" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Imap Wizard tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use Imap Wizard and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Imap Wizard or shows a Imap Wizard tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user imap-wizard -- npx -y imap-wizardClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"imap-wizard": {
"command": "npx",
"args": [
"-y",
"imap-wizard"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"imap-wizard": {
"command": "npx",
"args": [
"-y",
"imap-wizard"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"imap-wizard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"imap-wizard"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account Fe2-O3, which owns the repo
Code last changed yesterday
Uses LGPL-3.0
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/fe2-o3-imap-wizard)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed yesterday, and the latest version (0.3.6) reached the registry 2 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.
Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.
Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
| This one Imap Wizard | emailmd | Kite Discord Bot Builder | e2a — email for AI agents | Infobip MCP | kernelCAD | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | Yes | No |
| Basic checks | 3/3 | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | LGPL-3.0 | MIT | AGPL-3.0 | Apache-2.0 | MIT | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Let your AI assistant read, search, send and sort your email over plain IMAP and SMTP.
Quick start · Examples · Safety · Tools · Config · Clients · Troubleshooting
export_email and download_attachment can still save new files to folders you allow). Retried sends are caught, and email text is marked as untrusted so a message cannot pose as instructions.Works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, OpenCode and any other MCP client. Supports several accounts at once.
You need Node.js 22.13 or newer (24 recommended).
1. Add your account. A wizard asks for your address and password. It fills in the server settings for common providers.
npx -y imap-wizard account add
2. Check it works. This logs in to IMAP and SMTP for every account.
npx -y imap-wizard test
3. Connect your AI client.
Claude Code:
claude mcp add email -- npx -y imap-wizard stdio
Claude Desktop, Cursor or Windsurf: run the installer. It finds those apps, asks which ones to set up and how to launch the server (pick npx), then writes the config. Restart the app after.
npx -y imap-wizard install
Any other client takes this JSON (more formats under Other clients):
{
"mcpServers": { "email": { "command": "npx", "args": ["-y", "imap-wizard", "stdio"] } } }
Now ask your assistant: *"What's unread in my inbox?"*
Other ways to install
npm i -g imap-wizard, then use imap-wizard in place of npx -y imap-wizard (for example imap-wizard account add).ghcr.io/fe2-o3/imap-wizard (a tag per version, and latest). See Docker.io.github.Fe2-O3/imap-wizard. git clone https://github.com/Fe2-O3/imap-wizard.git
cd imap-wizard pnpm install && pnpm build node dist/main.js account add
Then point your client at node /absolute/path/to/imap-wizard/dist/main.js stdio.
[!NOTE]
Config is stored in
~/.config/email-mcp/. The folder name is kept from
upstream, so an existing email-mcp setup keeps working unchanged.
| Say this | What runs |
|---|---|
| "What's unread and older than a week?" | list_emails, sorted by date |
| "Find the Acme invoice from this month and save the PDF to my Downloads folder" | search_emails, get_email, download_attachment with savePath |
| "Reply to that thread: Thursday works, cc billing" | reply_email (uses Reply-To, files the reply in Sent) |
| "Is this sender legit?" | get_email_security (DMARC, SPF and DKIM results from the headers) |
| "Save that message as a file" | export_email (writes a .eml file) |
| "Triage my inbox and skip the newsletters" | triage_inbox prompt |
| "Move last month's receipts into Receipts" | search_emails, then bulk_action |
read_only not stopping background work, stdio processes that never exit, "Re: RE:" subjects stacking, and Sent copies rejected by strict servers. Full list with upstream status.get_email and export_email fetch with IMAP BODY.PEEK. Mail stays unread unless you ask (markRead: true).read_only = true, tools that change mail are not registered at all, so the assistant cannot even see them. export_email and download_attachment stay, and can still save new files to folders you allow.secret-tool, a password command (1Password, Bitwarden, pass), or OAuth2.imap-wizard tools. A shorter list is handy for local models.| Control | Default | What it does |
|---|---|---|
| Non-destructive reads | always | Reads use BODY.PEEK. Marking read takes an explicit markRead: true |
read_only | off | Hides every tool that changes mail and stops background services. markRead is refused. export_email and download_attachment can still save new files to allowed folders |
| Send rate limit | 10 per minute per account | Set with settings.rate_limit. Counted per running server: each AI window starts its own server with its own count, so two windows can send 20 |
| Duplicate-send guard | on | A retried send is spotted and refused unless you pass allow_duplicate (on send_email, reply_email, forward_email and send_draft). A send whose result is unknown is never retried for you: check Sent first |
| Who can receive mail | your client's approval | send_email, reply_email, forward_email and the other send tools can send to any address; your MCP client's approval prompt is the check. The forwarding allowlist below covers standing forwards (Sieve and local rules) only |
| Audit log | on | Writes are logged, with sensitive fields hidden, to ~/.local/share/email-mcp/audit.log |
| Untrusted-content markers | always | Email text in tool output is wrapped in << >> markers that tell the model it is data, not instructions |
| Safe file reading | always | Attachments sent by file path must be absolute, regular files; hidden files and folders (~/.ssh, .env), system folders, ~/Library and this app's own folders are refused, symlinks included |
| Preview before writing | opt-in per call | dryRun: true on send, reply, forward, send_draft, move, delete, bulk_action, mailbox and label deletes shows what would happen without doing it |
| One background worker | always | With several AI windows open, only one process runs the watcher, alerts and AI triage; another takes over within 2 minutes if it stops. If the lock file in the state folder cannot be used, none of them runs these until it can |
| Safe file saving | always | download_attachment (with savePath, up to 50 MB) and export_email save only to absolute paths, never overwrite a file, and refuse system folders, hidden folders, the home folder itself, this app's own folders, names that start with a dot and files that run when opened (.command, .app, .sh and similar). Two attachments with one name: pick one with occurrence |
| Alert webhook | off | Set only in config.toml (settings.hooks.alerts.webhook_url). configure_alerts cannot set or change it, and read tools show only its host |
| Protected mailboxes | always | delete_mailbox and rename_mailbox refuse INBOX, Sent, Drafts, Trash, Junk and Archive |
| Encrypted logins | enforced | A config with tls = false and starttls = false to a non-local host is refused when it loads |
| Credential redaction | always | Passwords and tokens in error text become [redacted]. The server's own reason for a failed login is kept |
| Mailbox-lock timeout | 60 s | A stuck connection is recycled instead of freezing later calls. A call that waits behind the background mirror sync just fails and can be retried; the sync keeps going |
| HTTP transport token | required | http mode makes a bearer token, even on localhost |
| Verification-code tool | off | get_verification_code exists only when you turn it on. It never reads your clipboard |
Body cache (read_through) | off | Message bodies are saved to disk only if you turn it on. Details |
What is on disk by default: your config.toml (readable only by you), the audit log, and a local SQLite copy of message headers and flags for INBOX over the last 90 days. Turn that copy off with settings.cache.enabled = false. Message bodies are not stored unless you turn on read_through.
To report a security problem, follow SECURITY.md. Please do not post exploits in public.
61 tools (31 read, 30 write), plus 1 opt-in tool, 7 prompts and 6 resources. In read-only mode only the 31 read tools are registered.
| Group | Tools |
|---|---|
| Read mail | list_accounts list_mailboxes list_emails search_emails get_email get_emails get_email_status get_thread download_attachment export_email find_email_folder extract_contacts get_email_stats get_email_security check_health list_templates |
| Calendar (read) | extract_calendar analyze_email_for_scheduling list_calendars list_events list_reminders check_calendar_permissions |
| Watcher (read) | get_watcher_status list_presets get_hooks_config check_notification_setup |
| Send *(write)* | send_email reply_email forward_email save_draft send_draft apply_template |
| Schedule *(write)* | schedule_email list_scheduled cancel_scheduled |
| Organize *(write)* | move_email delete_email mark_email bulk_action create_mailbox rename_mailbox delete_mailbox |
| Labels *(write)* | list_labels add_label remove_label create_label delete_label |
| Calendar and alerts *(write)* | add_to_calendar create_reminder configure_alerts test_notification |
| Filter rules (read) | sieve_status sieve_list_scripts sieve_get_script sieve_check_script list_local_rules |
| Filter rules *(write)* | sieve_put_script sieve_activate_script sieve_delete_script add_local_rule remove_local_rule |
| Opt-in | get_verification_code (needs settings.verification.enabled = true) |
Prompts: triage_inbox summarize_thread compose_reply draft_from_context extract_action_items summarize_meetings cleanup_inbox
Resources: email://accounts email://{account}/mailboxes email://{account}/unread email://{account}/stats email://templates/{name} email://scheduled