Install guide · Claude Desktop
Install emperor-mail for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
Add to Cursor: emperor-mailInstall in VS Code: emperor-mailInstall in VS Code Insiders: emperor-mail
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "yarenty-emperor-mail": { "command": "npx", "args": [ "-y", "emperor-mail@0.1.3" ], "env": { "MAIL_USER": "", "MAIL_PASSWORD": "YOUR_MAIL_PASSWORD", "MAIL_OAUTH_TOKEN": "YOUR_MAIL_OAUTH_TOKEN", "MAIL_FROM": "", "IMAP_HOST": "", "IMAP_PORT": "", "IMAP_SECURITY": "", "SMTP_HOST": "", "SMTP_PORT": "", "SMTP_SECURITY": "", "MAIL_WRITABLE": "false", "MAIL_ALLOW_SEND": "false", "MAIL_SEND_ALLOW": "", "MAIL_FROM_ALLOW": "" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |