Email MCP Server
%3D'quarkus.platform.version'%5D&label=Quarkus&color=blueviolet)
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
%3D'quarkus.platform.version'%5D&label=Quarkus&color=blueviolet)
Fast MCP server for handling email (IMAP and SMTP). Can for example be used with Claude Code and Claude App.
An MCP (Model Context Protocol) server that exposes common email operations as tools for LLM clients like Claude. Supports multiple named email accounts (e.g., work + Gmail) from a single server instance.
For more information, see my blog.
"Find the tax emails from my tax lawyers for 2025, and check the content and attachments to fully understand what documentation I need to provide. Please provide an action plan to get that documentation."
"Please help triage the emails in my inboxes. As per usual, flag anything that is actionable. Don't hesitate to read emails that you are uncertain about. For anything actionable, provide an action plan. For anything non-actionable, file according to the folder layout."
WARNING: This server performs real operations on your mailbox, for example moving emails around. By default it will not allow deletions and directly sending emails (this can be changed in the MCP config). The author assumes no responsibility for any loss of data or unintended consequences resulting from the use of this MCP server. Use at your own risk.
NOTE: That said, the author has been using this daily for weeks without issues.
All tools (except listAccounts) require an account parameter — the name of the account to operate on (e.g., work, gmail).
Plugin users: install Email MCP from the AI Plugins marketplace for Claude Code or Codex. See the plugin guide for installation and local credential setup.
The fastest way to get started is to download a pre-built release from the Releases page. Two options are available:
New builds use the email-mcp-server- filename prefix shown below. Older releases use mcp-email-server-;
use the filenames attached to the release you download. When upgrading a manually configured client,
update its executable or JAR path to the new filename.
Claude Desktop users: the simplest install is the MCP Bundle, email-mcp-server-<version>-macos-aarch64.mcpb
or email-mcp-server-<version>-windows-x86_64.mcpb, see Setting up with Claude Desktop.
No Java installation required. Download the binary for your platform:
On Linux and macOS, make the binary executable: chmod +x email-mcp-server-*
The macOS binary is signed and notarized, so Gatekeeper accepts it as downloaded. The one exception is a first launch while offline, because Gatekeeper fetches the notarization ticket from Apple; if that happens, clear the quarantine flag once:
xattr -d com.apple.quarantine email-mcp-server-<version>-macos-aarch64
Runs on any platform with Java 21+ installed. Download email-mcp-server-<version>-runner.jar.
Then configure your MCP client (see Claude Desktop or Claude Code below).
All credentials are passed via environment variables — nothing sensitive goes in source control. The LLM never sees these variables — it only sees tool names/descriptions and the text your tools return.
Accounts are defined by convention: EMAIL_ACCOUNTS_<NAME>_IMAP_* and EMAIL_ACCOUNTS_<NAME>_SMTP_*, where <NAME> is the account name in uppercase.
For Gmail, create an App Password.
FROM is the From address on everything the account sends or drafts, as a bare address or as
Display Name <address>. It defaults to the SMTP username, which is the address itself for most providers;
set it when the SMTP login is not an email address, to send from an alias, or to add a display name. Reply-all
leaves the account's own addresses (the From address and the usernames) out of the recipients.
You can define as many accounts as needed. For example, to add a work and gmail account, set environment
variables for both EMAIL_ACCOUNTS_WORK_* and EMAIL_ACCOUNTS_GMAIL_*.
With the default ports, IMAP is TLS on 993 and SMTP is port 587 upgraded with STARTTLS; the STARTTLS upgrade is required, so a server that does not offer it is refused rather than sent the password in the clear. The two other common setups need only the port, since the TLS mode follows it:
EMAIL_ACCOUNTS_<NAME>_SMTP_PORT=465. The connection is then encrypted from the first byte and the
STARTTLS setting is ignored.EMAIL_ACCOUNTS_<NAME>_IMAP_PORT=143. The connection is upgraded with
STARTTLS when the server offers it, and stays unencrypted otherwise (for a local or test server).For a non-standard port, set IMAP_SSL or SMTP_SSL explicitly; an explicit value always wins over the
port rule. Set SMTP_STARTTLS=false only for a server that really has no TLS at all.
saveDraft, moveToSpam and deleteEmail need to know the account's Drafts, spam and trash folders. Most
servers need no configuration; each folder is resolved on first use, in this order:
setDraftsFolder / setSpamFolder / setTrashFolder.EMAIL_ACCOUNTS_<NAME>_DRAFTS_FOLDER / _SPAM_FOLDER / _TRASH_FOLDER. A configured
folder that does not exist on the server is reported as an error rather than silently falling back, so
the LLM can point out the misconfiguration and work around it with the set*Folder tool for the session.\Drafts / \Junk / \Trash (RFC 6154 special-use, supported by Gmail,
Dovecot, Exchange and most others).Drafts, [Gmail]/Drafts, INBOX.Drafts, Spam, Junk, [Gmail]/Spam,
Trash, [Gmail]/Trash, Deleted Items.Drafts, Draft, Spam, Junk, Junk E-mail, Bulk Mail,
Junk Email, Trash, Deleted Items, Deleted Messages or a few localized trash names, which covers
providers that nest everything under a namespace prefix (e.g. OVH's INBOX.INBOX.Drafts).Set the variable explicitly if your provider uses a name none of the heuristics find, or if auto-detection
picks the wrong folder. deleteEmail removes the message permanently only when no trash folder is found.
One setting covers every connection of every account:
Without it a server that stops answering would hang the tool call, and with it the conversation, for good.
The wait is per socket read, not per operation, so a large attachment over a slow link is fine as long as
data keeps arriving. Raise it if a slow server times out on big searches; 0 disables the timeouts.
Equivalent system property: -Demail.network-timeout=60.
Permanent and outbound operations are opt-in for safety. By default the destructive/outbound tools are disabled and return an explanatory error so the LLM can tell the user what's happening and fall back to a safer alternative (moveEmail to a Trash folder, or saveDraft for the user to send manually).
Equivalent system properties: -Demail.allow-deletion=true and -Demail.allow-sending=true. Restart the server after changing them.
When EMAIL_ALLOW_DELETION is unset (or false), deleteEmail is still listed (so the LLM can discover it and explain the limitation), but every invocation is rejected before any IMAP call is made. Use moveEmail to a Trash folder as the safe alternative.
When EMAIL_ALLOW_SENDING is unset (or false), the four outbound tools above all return an explanatory error and do nothing. saveDraft is unaffected — it only writes to the IMAP Drafts folder (see Special folders), so the LLM can still compose messages for the user to review and send manually from their mail client. This is the recommended default workflow even when sending is enabled.
The easiest way is the MCP Bundle. There is no config file to edit:
Download the .mcpb file for your platform from the
Releases page:
email-mcp-server-<version>-macos-aarch64.mcpb or email-mcp-server-<version>-windows-x86_64.mcpb.
Install it: double-click the file, or in Claude Desktop open Settings → Extensions → Advanced settings → Install Extension… and pick the file. Claude Desktop shows its standard unsigned-extension notice, because the bundle file itself carries no signature (the binary inside it is signed); confirm with Install.
Installing does not ask for the account details, so open the extension's settings: in Settings → Extensions, find Email MCP Server and click Configure. Fill in the IMAP and SMTP server, username and password (passwords go to the operating system keychain). For Gmail, use an App Password. The optional fields can usually stay empty: From only if the SMTP username is not your email address or you want a display name, and the Drafts, Spam and Trash folder fields only for providers where auto-detection picks the wrong folder (see Special folders). Leave the two switches, Allow sending and Allow permanent deletion, off unless you need them. Save.
Make sure the extension is enabled and start a new chat. The email tools appear in the tool list; the
account is called default in the tools.
The bundle contains the same native binary as the standalone download, signed and notarized on macOS and Authenticode-signed on Windows. It configures a single account with the default ports (993 with SSL for IMAP, 587 with STARTTLS for SMTP); for several accounts, or other ports and SSL settings, use the manual route below.
If you prefer the manual route:
Download a release (see Quick Start) or build from source.
Edit the Claude Desktop config file claude_desktop_config.json.
On Windows it is located at C:\Users\<UserName>\AppData\Roaming\Claude\claude_desktop_config.json.
On macOS it is at ~/Library/Application Support/Claude/claude_desktop_config.json.
Add the email entry to the mcpServers section. Here is an example with two accounts (work and gmail):
Using the native binary (Windows):
{
"mcpServers": {
"email": {
"command": "C:\\Users\\YourName\\path\\to\\email-mcp-server-windows-x86_64.exe",
"args": [
"-Dquarkus.mcp.server.stdio.enabled=true",
"-Dquarkus.config.locations=.",
"-Duser.dir=C:\\Users\\YourName\\claude"
],
"env": {
"EMAIL_ACCOUNTS_WORK_IMAP_HOST": "imap.example.com",
"EMAIL_ACCOUNTS_WORK_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_IMAP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_WORK_SMTP_HOST": "smtp.example.com",
"EMAIL_ACCOUNTS_WORK_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_SMTP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_GMAIL_IMAP_HOST": "imap.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_IMAP_PASSWORD": "your-gmail-app-password",
"EMAIL_ACCOUNTS_GMAIL_SMTP_HOST": "smtp.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_SMTP_PASSWORD": "your-gmail-app-password"
}
}
}
}
Using the uber-jar:
{
"mcpServers": {
"email": {
"command": "java",
"args": [
"-Dquarkus.mcp.server.stdio.enabled=true",
"-Dquarkus.config.locations=.",
"-Duser.dir=C:\\Users\\YourName\\claude",
"-jar",
"C:\\Users\\YourName\\path\\to\\email-mcp-server-runner.jar"
],
"env": {
"EMAIL_ACCOUNTS_WORK_IMAP_HOST": "imap.example.com",
"EMAIL_ACCOUNTS_WORK_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_IMAP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_WORK_SMTP_HOST": "smtp.example.com",
"EMAIL_ACCOUNTS_WORK_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_SMTP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_GMAIL_IMAP_HOST": "imap.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_IMAP_PASSWORD": "your-gmail-app-password",
"EMAIL_ACCOUNTS_GMAIL_SMTP_HOST": "smtp.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_SMTP_PASSWORD": "your-gmail-app-password"
}
}
}
}
Download a release (see Quick Start) or build from source.
Edit ~/.claude.json and add an mcpServers section. Here is an example with two accounts (work and gmail):
Using the native binary (Linux):
{
"mcpServers": {
"email": {
"command": "/path/to/email-mcp-server-linux-x86_64",
"args": [
"-Dquarkus.mcp.server.stdio.enabled=true"
],
"env": {
"EMAIL_ACCOUNTS_WORK_IMAP_HOST": "imap.example.com",
"EMAIL_ACCOUNTS_WORK_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_IMAP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_WORK_SMTP_HOST": "smtp.example.com",
"EMAIL_ACCOUNTS_WORK_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_SMTP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_GMAIL_IMAP_HOST": "imap.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_IMAP_PASSWORD": "your-gmail-app-password",
"EMAIL_ACCOUNTS_GMAIL_SMTP_HOST": "smtp.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_SMTP_PASSWORD": "your-gmail-app-password"
}
}
}
}
Using the uber-jar:
{
"mcpServers": {
"email": {
"command": "java",
"args": [
"-Dquarkus.mcp.server.stdio.enabled=true",
"-jar",
"/path/to/email-mcp-server-runner.jar"
],
"env": {
"EMAIL_ACCOUNTS_WORK_IMAP_HOST": "imap.example.com",
"EMAIL_ACCOUNTS_WORK_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_IMAP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_WORK_SMTP_HOST": "smtp.example.com",
"EMAIL_ACCOUNTS_WORK_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_WORK_SMTP_PASSWORD": "your-app-password",
"EMAIL_ACCOUNTS_GMAIL_IMAP_HOST": "imap.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_IMAP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_IMAP_PASSWORD": "your-gmail-app-password",
"EMAIL_ACCOUNTS_GMAIL_SMTP_HOST": "smtp.gmail.com",
"EMAIL_ACCOUNTS_GMAIL_SMTP_USERNAME": "[email protected]",
"EMAIL_ACCOUNTS_GMAIL_SMTP_PASSWORD": "your-gmail-app-password"
}
}
}
}
/mcp to reconnect). The email tools should appear in the tool list.Note: Unlike Claude Desktop, Claude Code does not typically need the -Duser.dir and -Dquarkus.config.locations workarounds since it launches the server from a normal working directory.
Only needed if you want to contribute or run a development build. Building the uber-jar and the native images, running the integration tests, packing the MCP Bundles and signing the binaries are described in docs/DEVELOPMENT.md.
AccessDeniedException: C:\WINDOWS\system32\config: on Windows, Claude Desktop may launch the server with C:\WINDOWS\system32 as the working directory, causing Quarkus to fail when scanning for config files. The -Duser.dir argument in the example config overrides the working directory, and -Dquarkus.config.locations=. prevents Quarkus from scanning restricted system directories. Point -Duser.dir to any directory your user can write to.-Dquarkus.mcp.server.stdio.enabled=true is in the args before -jar.email-mcp-server.log (in the working directory), not to stdout/stderr, to avoid interfering with the STDIO transport. Check that file for errors. With the MCP Bundle the working directory is your home directory, so the log is ~/email-mcp-server.log.listAccounts first to see which accounts are configured. Account names are lowercase as defined in the environment variables (e.g., work, gmail).The server is released under the BSD 3-Clause License, see LICENSE. The release artifacts bundle third-party libraries under their own licenses; they are listed, with their licenses, in docs/THIRD-PARTY.md. Note in particular that PDF text extraction uses iText 7, which is licensed under the GNU Affero General Public License v3.0; see the note in that file.
Fast MCP server for handling email (IMAP and SMTP). Can for example be used with Claude Code and Claude App.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Email은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-28. Fast MCP server for handling email (IMAP and SMTP). Can for example be used with Claude Code and Claude App.