Moving from the old email-mcp
After this page, you can move the account of the first version of email-mcp into the new version, with one command.
The first version of email-mcp read its settings from a .env file (a text file
of settings), or from the env block of the AI app config (IMAP_HOST,
IMAP_USERNAME, and so on). That version is gone. One command moves its account
into the new database. The command reads only a file, never the config of an AI
app.
If your settings are only in the env block of the config of your AI app, make
the file first. Open the config, and find the env block of the old email-mcp.
Then make a new text file called .env, and write one line NAME=VALUE for
each variable of the block. These four names are required:
IMAP_HOST=imap.example.com
IMAP_USERNAME=you@example.com
IMAP_PASSWORD=your-password
SMTP_HOST=smtp.example.com
Add IMAP_PORT, IMAP_TLS, SMTP_PORT, SMTP_TLS, SMTP_USERNAME and
SMTP_PASSWORD only when the block has them. When IMAP_PORT is missing, the
command uses 993, and when SMTP_PORT is missing, it uses 587. When IMAP_TLS
or SMTP_TLS is missing, it is true. A name may come only once in the file. A
line that starts with # is a comment (a note that the command skips). The file
holds your password in plain text, so you delete it after the import (see the
end of this page).
Then run the command in a terminal (a window where you type commands):
email-mcp import-env path/to/.env
Without a path it reads .env in the current folder.
- It reads
IMAP_HOST,IMAP_PORT,IMAP_USERNAME,IMAP_PASSWORD,IMAP_TLS,SMTP_HOST,SMTP_PORT,SMTP_USERNAME,SMTP_PASSWORDandSMTP_TLS, tests the connection, and saves one account at Mail 4. IMAP (Internet Message Access Protocol) is the protocol for reading mail. SMTP (Simple Mail Transfer Protocol) is the protocol for sending mail. TLS (Transport Layer Security) encrypts a connection. Mail 4 is the mail level 4, named Send on the web pages. See Permission levels. SMTP_USERNAMEandSMTP_PASSWORDmust be missing or the same as the IMAP ones. The new email-mcp uses one login for both servers. If they differ, useemail-mcp account addinstead.- When
IMAP_USERNAMEis not an email address, give the address with--email. IMAP_TLS=falseorSMTP_TLS=falseworks only for a server on your own computer (such as a local bridge: a program on your own computer that offers IMAP and SMTP servers for a mail service), and only with--plaintext-i-understand. To any other server it is refused.
If the file sets USE_OAUTH=true, the command refuses with exactly this
message. OAuth is a way to sign in without giving a program your password. An
app password is a separate password that you make in your mail account for one
program.
This .env uses OAuth (USE_OAUTH=true). OAuth accounts are not supported until Google (M1) and Microsoft (M2) support ships. Connect this account with an app password instead.
After the import:
- Delete the
.envfile. It holds your password in plain text. This is also true of a file that you made from theenvblock. - Remove the old
envblock (theIMAP_*andSMTP_*variables) from the config of your AI app, and register the server again as shown on the page Claude Code, or on the page of your own AI app, which Connect an AI app lists.