Skip to content
Back to search

mcp-email-server

Full-featured, multi-account MCP email server for Windows, macOS, and Linux—read, search, organize, and send email via IMAP and SMTP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Wh1isper/mcp-email-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Wh1isper/mcp-email-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wh1isper--mcp-email-server/badge.svg)](/listings/wh1isper--mcp-email-server)

HTML

<a href="/listings/wh1isper--mcp-email-server"><img src="/api/listings/wh1isper--mcp-email-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Configure an email account

From this source checkout, run the configuration UI with [`uv`](https://docs.astral.sh/uv/):

uv sync
uv run mcp-email-server ui

For a published release whose notes state that it includes Local Email App V2, `uvx mcp-email-server@latest ui` is the equivalent temporary invocation.

Keep the foreground command running. On a truly empty installation, the authenticated browser session prepares private account storage at the safe local default; existing TOML or environment configuration instead offers an explicit import review while the previous settings keep running. The account-first UI has only **Email accounts** and **Settings & help** as primary destinations. Start with the email address and password; the UI fills common connection settings from the email domain and keeps them editable, while outgoing mail remains optional. A saved complete account is ready without a separate activation step. Use **Password & test** on the saved account if desired, then restart the MCP client to apply the selected settings.

2. Configure the MCP client

Use the same V2-capable distribution for stdio as for the UI. For a published V2 release, add the following server definition to the MCP client:

{
  "mcpServers": {
    "mcp-email-server": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

Restart the MCP client after updating its configuration. When testing this source checkout before publication, invoke `uv run --directory /absolute/path/to/mcp-email-server mcp-email-server stdio` instead of pairing a managed catalog with PyPI `@latest`.

3. Verify the connection

Ask the client to list the configured email accounts or recent messages.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "mcp-email-server",
  4. "version": "0.0.1",
  5. "description": "Email MCP tools with safe, non-secret setup guidance.",
  6. "owner": {
  7. "name": "wh1isper"
  8. },
  9. "plugins": [
  10. {
  11. "name": "mcp-email-server",
  12. "source": "./plugins/mcp-email-server",
  13. "description": "Use email through MCP while handing secret entry to the user-operated CLI or local UI.",
  14. "version": "0.0.1",
  15. "author": {
  16. "name": "wh1isper"
  17. },
  18. "homepage": "https://mcp-email-server.wh1isper.top/",
  19. "repository": "https://github.com/Wh1isper/mcp-email-server",
  20. "license": "MIT",
  21. "keywords": ["email", "mcp", "security"],
  22. "category": "Productivity"
  23. }
  24. ]
  25. }
README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-email-server
  2. [![Release](https://img.shields.io/github/v/release/Wh1isper/mcp-email-server)](https://github.com/Wh1isper/mcp-email-server/releases)
  3. [![Build status](https://img.shields.io/github/actions/workflow/status/Wh1isper/mcp-email-server/main.yml?branch=main)](https://github.com/Wh1isper/mcp-email-server/actions/workflows/main.yml?query=branch%3Amain)
  4. [![codecov](https://codecov.io/gh/Wh1isper/mcp-email-server/graph/badge.svg?token=0mToRybKx8)](https://codecov.io/gh/Wh1isper/mcp-email-server)
  5. [![License](https://img.shields.io/github/license/Wh1isper/mcp-email-server)](https://github.com/Wh1isper/mcp-email-server/blob/main/LICENSE)
  6. An MCP server for reading, searching, organizing, and sending email through
  7. IMAP and SMTP.
  8. > [!NOTE]
  9. > Version 1.0.0 introduces Local Email App V2. Updating the package does not
  10. > automatically import existing settings created with PyPI 0.16.0 and earlier:
  11. > they remain active in backward-compatible `legacy` mode, so there is no required
  12. > migration. If you
  13. > would like to use the new managed storage, you can review and import those
  14. > settings whenever it is convenient.
  15. `mcp-email-server` supports Windows, macOS, and Linux. See
  16. [Security](docs/security.md) for platform-specific filesystem and credential
  17. storage details.
  18. ## Optional migration for existing installations
  19. An `@latest` release that includes Local Email App V2 offers a preview-first
  20. CLI migration:
  21. ```bash
  22. uvx mcp-email-server@latest config init \
  23. --database ~/.config/mcp-email-server/managed.sqlite3
  24. uvx mcp-email-server@latest config import-legacy
  25. uvx mcp-email-server@latest config import-legacy --apply
  26. uvx mcp-email-server@latest config doctor
  27. ```
  28. The apply step displays the plan again and asks for `IMPORT` confirmation. A
  29. complete import selects managed mode; otherwise the existing legacy settings
  30. remain selected. The source TOML file and its legacy keyring entries are left
  31. untouched. You can also run `uvx mcp-email-server@latest ui` and choose **Import
  32. existing settings**. After a successful import, restart running MCP clients. See
  33. the detailed [upgrade guidance](docs/getting-started.md#upgrading-to-local-email-app-v2)
  34. and [import troubleshooting](docs/troubleshooting.md#legacy-import-reports-a-conflict-or-missing-credential).
  35. ## Quick start
  36. ### 1. Configure an email account
  37. From this source checkout, run the configuration UI with
  38. [`uv`](https://docs.astral.sh/uv/):
  39. ```bash
  40. uv sync
  41. uv run mcp-email-server ui
  42. ```
  43. For a published release whose notes state that it includes Local Email App V2,
  44. `uvx mcp-email-server@latest ui` is the equivalent temporary invocation.
  45. Keep the foreground command running. On a truly empty installation, the
  46. authenticated browser session prepares private account storage at the safe local
  47. default; existing TOML or environment configuration instead offers an explicit
  48. import review while the previous settings keep running. The account-first UI has
  49. only **Email accounts** and **Settings & help** as primary destinations. Start
  50. with the email address and password; the UI fills common connection settings from
  51. the email domain and keeps them editable, while outgoing mail remains optional.
  52. A saved complete account is ready without a separate activation step. Use
  53. **Password & test** on the saved account if desired, then restart the MCP client
  54. to apply the selected settings.
  55. ### 2. Configure the MCP client
  56. Use the same V2-capable distribution for stdio as for the UI. For a published
  57. V2 release, add the following server definition to the MCP client:
  58. ```json
  59. {
  60. "mcpServers": {
  61. "mcp-email-server": {
  62. "command": "uvx",
  63. "args": ["mcp-email-server@latest", "stdio"]
  64. }
  65. }
  66. }
  67. ```
  68. Restart the MCP client after updating its configuration. When testing this
  69. source checkout before publication, invoke `uv run --directory
  70. /absolute/path/to/mcp-email-server mcp-email-server stdio` instead of pairing a
  71. managed catalog with PyPI `@latest`.
  72. ### 3. Verify the connection
  73. Ask the client to list the configured email accounts or recent messages.
  74. ## Other configuration methods
  75. For the SQLite-backed managed CLI workflow, Windows and POSIX storage boundaries,
  76. headless environments, multiple accounts, custom TLS settings, and
  77. environment-variable configuration, see the
  78. [documentation](https://mcp-email-server.wh1isper.top/). Release 1.6.2 and later
  79. also publish Linux `amd64`/`arm64` images at
  80. `ghcr.io/wh1isper/mcp-email-server`; see the
  81. [container instructions](https://mcp-email-server.wh1isper.top/getting-started/#run-the-official-container-image).
  82. ## Documentation
  83. - [Getting Started](https://mcp-email-server.wh1isper.top/getting-started/)
  84. - [Configuration](https://mcp-email-server.wh1isper.top/configuration/)
  85. - [MCP Tools](https://mcp-email-server.wh1isper.top/tools/)
  86. - [Transports](https://mcp-email-server.wh1isper.top/transports/)
  87. - [Security](https://mcp-email-server.wh1isper.top/security/)
  88. - [Troubleshooting](https://mcp-email-server.wh1isper.top/troubleshooting/)
  89. ## Development
  90. See [CONTRIBUTING.md](https://github.com/Wh1isper/mcp-email-server/blob/main/CONTRIBUTING.md).
  91. ## License
  92. This project is licensed under the terms of the [LICENSE](https://github.com/Wh1isper/mcp-email-server/blob/main/LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.