mcp-email

MCP server for sending emails. Supports SMTP and Resend providers.

Installation

cd mcp-servers/email
uv sync

Providers

Set EMAIL_PROVIDER to choose the backend:

Provider Value Required env vars
SMTP (default) smtp SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD
Resend resend RESEND_API_KEY, RESEND_FROM

SMTP Configuration

EMAIL_PROVIDER=smtp            # or omit (default)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=you@gmail.com
SMTP_PASSWORD=your-app-password
SMTP_FROM=you@gmail.com        # defaults to SMTP_USERNAME
SMTP_USE_TLS=true              # default: true

Resend Configuration

EMAIL_PROVIDER=resend
RESEND_API_KEY=re_xxxxxxxxxxxx
RESEND_FROM=you@yourdomain.com

Usage

With Claude Desktop / Claude Code

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-servers/email", "mcp-email"],
      "env": {
        "EMAIL_PROVIDER": "smtp",
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password"
      }
    }
  }
}

Tools

send_email — Send an email

Parameter Type Required Description
to string[] yes Recipient email addresses
subject string yes Email subject line
body string yes Email body content
html boolean no Whether body is HTML (default: plain text)
cc string[] no CC recipients
bcc string[] no BCC recipients
attachments object[] no File attachments (see below)

Attachments format:

{
  "path": "/absolute/path/to/file.pdf",
  "filename": "report.pdf"
}

Or with base64 content:

{
  "content_base64": "SGVsbG8gd29ybGQ=",
  "filename": "hello.txt"
}

Gmail Setup

For Gmail, use an App Password:

  1. Enable 2-Step Verification on your Google account
  2. Generate an App Password for "Mail"
  3. Use that as SMTP_PASSWORD

Resend Setup

  1. Sign up at resend.com
  2. Add and verify your domain
  3. Create an API key
  4. Set RESEND_API_KEY and RESEND_FROM

Project links

Data verified by PyPI on Jul 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for uania from gravatar.com uania

Credits

Author: uaniay

GitHub Statistics

Data verified by PyPI on Jul 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

ai-agent email mcp resend smtp

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_email_sender-0.1.2.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_email_sender-0.1.2-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file mcp_email_sender-0.1.2.tar.gz.

File metadata

  • Download URL: mcp_email_sender-0.1.2.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_email_sender-0.1.2.tar.gz
Algorithm Hash digest
SHA256 ce2d068478c50b9a950e6ca481adb350b0a35e879453d0d2f7c600674bcb3f4d
MD5 b8c3f3b191c5d831d8b32104fc3a7fc4
BLAKE2b-256 ead79456cf12165fed9e31737b32b95396748f0a74a788a71509a89e3dd97bfb

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_email_sender-0.1.2.tar.gz:

Publisher: publish.yml on uaniay/plugins

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_email_sender-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_email_sender-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b2898c1c5c510ed5bb98320ef3773c579c8b63afe4a78393a265e97b9cb03191
MD5 63b9315dc72561b7b181185b61122fa1
BLAKE2b-256 2319e8bbc96a4e56dc88dce3d5e0bc26c9d6d4ce7dd81740d291dec517ec260d

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_email_sender-0.1.2-py3-none-any.whl:

Publisher: publish.yml on uaniay/plugins

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page