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.

What is amotivv protonmail mcp

Protonmail MCP Server

*License: MIT*

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/claude-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.

Leave a Comment

Frequently Asked Questions

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications, providing a standardized way to connect AI models to different data sources and tools.

What are MCP Servers?

MCP Servers are lightweight programs that expose specific capabilities through the standardized Model Context Protocol. They act as bridges between LLMs like Claude and various data sources or services, allowing secure access to files, databases, APIs, and other resources.

How do MCP Servers work?

MCP Servers follow a client-server architecture where a host application (like Claude Desktop) connects to multiple servers. Each server provides specific functionality through standardized endpoints and protocols, enabling Claude to access data and perform actions through the standardized protocol.

Are MCP Servers secure?

Yes, MCP Servers are designed with security in mind. They run locally with explicit configuration and permissions, require user approval for actions, and include built-in security features to prevent unauthorized access and ensure data privacy.

Related MCP Servers

chrisdoc hevy mcp avatar

chrisdoc hevy mcp

mcp
sylphlab pdf reader mcp avatar

sylphlab pdf reader mcp

An MCP server built with Node.js/TypeScript that allows AI agents to securely read PDF files (local or URL) and extract text, metadata, or page counts. Uses pdf-parse.

pdf-parsetypescriptnodejs
aashari mcp server atlassian bitbucket avatar

aashari mcp server atlassian bitbucket

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

atlassianrepositorymcp
aashari mcp server atlassian confluence avatar

aashari mcp server atlassian confluence

Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.

atlassianmcpconfluence
prisma prisma avatar

prisma prisma

Next-generation ORM for Node.js & TypeScript | PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, MongoDB and CockroachDB

cockroachdbgomcp
Zzzccs123 mcp sentry avatar

Zzzccs123 mcp sentry

mcp sentry for typescript sdk

mcptypescript
zhuzhoulin dify mcp server avatar

zhuzhoulin dify mcp server

mcp
zhongmingyuan mcp my mac avatar

zhongmingyuan mcp my mac

mcp
zhixiaoqiang desktop image manager mcp avatar

zhixiaoqiang desktop image manager mcp

MCP 服务器,用于管理桌面图片、查看详情、压缩、移动等(完全让Trae实现)

mcp
zhixiaoqiang antd components mcp avatar

zhixiaoqiang antd components mcp

An MCP service for Ant Design components query | 一个减少 Ant Design 组件代码生成幻觉的 MCP 服务,包含系统提示词、组件文档、API 文档、代码示例和更新日志查询

designantdapi

Submit Your MCP Server

Share your MCP server with the community

Submit Now