Imap MCP server
{
"mcpServers": {
"aiwerk-imap": {
"command": "npx",
"args": [
"-y",
"@aiwerk/mcp-server-imap@latest"
],
"env": {
"IMAP_HOST": "<imap_host>",
"IMAP_USER": "<imap_user>"
}
}
}
}{
"mcpServers": {
"aiwerk-imap": {
"command": "npx",
"args": [
"-y",
"@aiwerk/mcp-server-imap@latest"
],
"env": {
"IMAP_HOST": "<imap_host>",
"IMAP_USER": "<imap_user>"
}
}
}
}{
"mcpServers": {
"aiwerk-imap": {
"command": "npx",
"args": [
"-y",
"@aiwerk/mcp-server-imap@latest"
],
"env": {
"IMAP_HOST": "<imap_host>",
"IMAP_USER": "<imap_user>"
}
}
}
}{
"servers": {
"aiwerk-imap": {
"command": "npx",
"args": [
"-y",
"@aiwerk/mcp-server-imap@latest"
],
"env": {
"IMAP_HOST": "${input:imap_host}",
"IMAP_USER": "${input:imap_user}"
}
}
},
"inputs": [
{
"id": "imap_host",
"type": "promptString",
"description": "Imap host",
"password": true
},
{
"id": "imap_user",
"type": "promptString",
"description": "Imap user",
"password": true
}
]
}{
"mcpServers": {
"aiwerk-imap": {
"command": "npx",
"args": [
"-y",
"@aiwerk/mcp-server-imap@latest"
],
"env": {
"IMAP_HOST": "<imap_host>",
"IMAP_USER": "<imap_user>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @aiwerk/mcp-server-imapversion 1.2.1
What it does
This MCP server exposes email reading and management tools via standard IMAP/SMTP, compatible with any email provider. It is for developers who need to integrate email capabilities into AI agents or applications without being locked into a single email service.
- List, read, search, and retrieve emails from any IMAP mailbox
- Manage emails by flagging, moving to folders, and deleting messages
- Send emails and compose replies using SMTP (when explicitly enabled locally)
Tools this server exposes
| Tool | Does |
|---|---|
| email_list | List emails from a specified folder with pagination and filtering options |
| email_read | Retrieve and parse the full content of a specific email, including attachments and MIME parts |
| email_search | Search emails across a mailbox using IMAP search criteria |
| email_folders | List all folders and mailboxes available in the email account |
| email_flag | Mark emails as read, starred, or apply other IMAP flags |
| email_move | Move emails from one folder to another |
| email_delete | Delete emails from the mailbox |
| email_attachment | Download or access attachments from emails |
| email_send | Send an email via SMTP (local-only, disabled by default) |
| email_reply | Compose and send a reply to an existing email (local-only, disabled by default) |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.