Protonmail

by amotivv

6 stars
671 downloads
Not rated
GitHub

About

Enables sending emails through Protonmail's SMTP service with support for multiple recipients, CC/BCC functionality, and both plain text and HTML content.

Details

Author
amotivv
Repository
amotivv/protonmail-mcp
GitHub stars
6
Downloads
671
License
MIT License
Categories
Productivity, Design, Developer Tools, AI, Infrastructure, Frontend

Jump to

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Protonmail
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

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

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.

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)

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.

send_email

Sends an email using your Protonmail SMTP account. Parameters: to (recipient email address(es)), subject (email subject line), body (email body content), isHtml (optional, whether the body contains HTML content), cc (optional, CC recipient(s)), bcc (optional, BCC recipient(s))

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "protonmail": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Protonmail MCP Server

<p align="center">
This MCP server is provided by <a href="https://amotivv.com">amotivv, inc.</a>, the creators of <a href="https://memorybox.dev">Memory Box</a>.
</p>

License: MIT

<p align="center">
<a href="https://github.com/amotivv/memory-box">
Memory Box
</a>
</p>

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:

- Official MCP Servers Repository - Collection of official MCP servers
- Awesome-MCP Servers Repository - Community-curated list of MCP servers
- mcpservers.org - Online directory of MCP servers
- mcp.so - Another directory for discovering MCP servers

License

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

{
    "mcpServers": {
        "protonmail": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

More like this

Similar MCP servers you might find useful

Browse category

Time

A Model Context Protocol server that provides time and timezone conversion capabilities. It enables LLMs to get current time information and perform timezone…

88.2k
Productivity

Git

A Model Context Protocol (MCP) server that provides tools for LLMs to read, search, and manipulate Git repositories. It enables automated repository…

88.1k
Developer Tools

Context 7

Official Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.

58.7k
Developer Tools