Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

protonmail-mcp

MCP.Pizza Chef: amotivv

The protonmail-mcp server enables secure email sending through Protonmail's SMTP service, integrating seamlessly with Claude Desktop and the Cline VSCode extension. It allows users to send emails using their Protonmail credentials directly from these platforms, facilitating streamlined communication workflows within AI-enhanced environments. This server supports cross-platform compatibility, ensuring consistent email functionality across desktop and code editor contexts.

Use This MCP server To

Send emails from Claude Desktop using Protonmail credentials Send emails from Cline VSCode extension via Protonmail SMTP Automate email dispatch within AI workflows using Protonmail Integrate Protonmail email sending into developer tools Enable secure email sending in AI-powered coding environments

README

Protonmail MCP Server

This MCP server is provided by amotivv, inc., the creators of Memory Box.

License: MIT

Memory Box

This MCP server provides email sending functionality using Protonmail's SMTP service. It allows both Claude Desktop and Cline VSCode extension to send emails on your behalf using your Protonmail credentials.

Compatibility

This MCP server is compatible with:

  • Claude Desktop App: The standalone desktop application for Claude
  • Cline VSCode Extension: The Claude extension for Visual Studio Code

The same implementation works across both platforms since they both use the Model Context Protocol (MCP) standard.

Features

  • Send emails to one or multiple recipients
  • Support for CC and BCC recipients
  • Support for both plain text and HTML email content
  • Comprehensive error handling and logging

Configuration

The server requires the following environment variables to be set in the MCP settings files for both Claude Desktop and Cline:

Claude Desktop Configuration

Located at: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json

Cline VSCode Extension Configuration

Located at: /Users/your-username/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Both configuration files require the following environment variables:

  • PROTONMAIL_USERNAME: Your Protonmail email address
  • PROTONMAIL_PASSWORD: Your Protonmail SMTP password (not your regular login password)
  • PROTONMAIL_HOST: SMTP server hostname (default: smtp.protonmail.ch)
  • PROTONMAIL_PORT: SMTP server port (default: 587 for STARTTLS, 465 for SSL/TLS)
  • PROTONMAIL_SECURE: Whether to use a secure connection (default: "false" for port 587, "true" for port 465)
  • DEBUG: Enable debug logging (set to "true" to see detailed logs, "false" to hide them)

For detailed information about Protonmail's SMTP service, including how to get your SMTP password, please refer to the official Protonmail SMTP documentation.

Usage

Once configured, you can use the MCP server to send emails with the following tool:

send_email

Sends an email using your Protonmail SMTP account.

Parameters:

  • to: Recipient email address(es). Multiple addresses can be separated by commas.
  • subject: Email subject line
  • body: Email body content (can be plain text or HTML)
  • isHtml: (Optional) Whether the body contains HTML content (default: false)
  • cc: (Optional) CC recipient(s), separated by commas
  • bcc: (Optional) BCC recipient(s), separated by commas

Example:

<use_mcp_tool>
<server_name>protonmail-mcp</server_name>
<tool_name>send_email</tool_name>
<arguments>
{
  "to": "recipient@example.com",
  "subject": "Test Email from Cline",
  "body": "This is a test email sent via the Protonmail MCP server.",
  "cc": "optional-cc@example.com"
}
</arguments>
</use_mcp_tool>

Troubleshooting

If you encounter issues with the MCP server, check the following:

  1. Ensure your Protonmail SMTP credentials are correct in both configuration files
  2. Verify that the SMTP port is not blocked by your firewall
  3. Check if your Protonmail account has any sending restrictions
  4. Look for error messages in the logs:
    • Claude Desktop app logs
    • Cline VSCode extension output panel
  5. Restart the Claude Desktop app or reload the VSCode window after configuration changes

Development

To build the project:

cd protonmail-mcp
npm install
npm run build

To modify the server, edit the files in the src directory and rebuild the project.

Installation

This MCP server can be installed in both Claude Desktop and Cline VSCode extension. Here's how to add it to your environment:

Manual Installation

  1. Clone this repository to your local machine:

    git clone https://github.com/your-username/protonmail-mcp.git
    cd protonmail-mcp
  2. Install dependencies and build the project:

    npm install
    npm run build
  3. Add the server configuration to your MCP settings files (see Configuration section above)

Using Cline to Install from GitHub

Cline can automatically clone and build MCP servers from GitHub repositories. To use this feature:

  1. Provide Cline with the GitHub repository URL
  2. Let Cline clone and build the server
  3. Provide any necessary configuration information (like SMTP credentials)

For detailed instructions on installing MCP servers from GitHub using Cline, see the Cline MCP Server Installation Documentation.

Resources

  • Protonmail SMTP Documentation - Official guide for using Protonmail's SMTP service
  • Nodemailer Documentation - The email sending library used by this MCP server
  • Model Context Protocol Documentation - Documentation for the MCP protocol
  • Claude Desktop App - Download the Claude Desktop application
  • Cline VSCode Extension - Install the Cline extension for VSCode
  • Cline MCP Documentation - Cline's documentation for MCP servers
  • Installing MCP Servers from GitHub - Guide for installing MCP servers from GitHub repositories

Finding More MCP Servers

You can find additional MCP servers in these repositories and directories:

License

This project is licensed under the MIT License - see the LICENSE file for details.

protonmail-mcp FAQ

How do I configure protonmail-mcp with Claude Desktop?
Provide your Protonmail credentials in the Claude Desktop app settings to enable email sending via this MCP server.
Can I use protonmail-mcp with other email clients?
This server is specifically designed for integration with Claude Desktop and Cline VSCode extension.
Is my Protonmail password stored securely by protonmail-mcp?
Yes, the server uses secure methods to handle your credentials, ensuring privacy and security.
Does protonmail-mcp support sending attachments?
Attachment support depends on the client (Claude Desktop or Cline VSCode); the server facilitates SMTP sending capabilities.
Is protonmail-mcp open source?
Yes, it is open source under the MIT license, available on GitHub.
Can I use protonmail-mcp with multiple Protonmail accounts?
Yes, you can configure different accounts in supported clients to send emails via this server.
What platforms support protonmail-mcp?
It supports Claude Desktop and the Cline VSCode extension across desktop and coding environments.