ProtonMail MCP Connector
CrashBytes/protonmail-mcp-connector
Integre ProtonMail ao Claude com leitura, envio e busca de emails
Ver no GitHubServidor MCP que conecta Claude e assistentes de IA ao ProtonMail, permitindo listar, ler, enviar e buscar emails de forma segura. Implementa persistência de sessão para minimizar autenticações repetidas.
Instalação
npx convez-ai CrashBytes/protonmail-mcp-connector1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Ler e responder emails via Claude sem abrir webmail
- Automatizar busca e filtragem de mensagens por critério
- Integrar fluxos de email em workflows com IA
Veredito

Ferramenta sólida para integração ProtonMail com Claude, com implementação clara de autenticação e operações de email. Útil para quem quer automatizar gestão de emails via IA, embora requeira tratamento cauteloso de credenciais.
README
A tradução para o português deste README ainda está na fila.
ProtonMail MCP Connector
A Model Context Protocol (MCP) server that enables Claude and other AI assistants to interact with ProtonMail.
Features
- 📧 List Messages - View recent emails from your inbox
- 📖 Read Messages - Read full message content
- ✉️ Send Emails - Compose and send emails
- 🔍 Search - Search through your emails
- 🔐 Secure - Uses session persistence to minimize authentication
Prerequisites
- Python 3.10 or higher
- A ProtonMail account
- uv package manager (recommended)
- Claude Desktop (for MCP integration)
Installation
1. Install uv (if not already installed)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2. Set up the project
cd protonmail-mcp-connector
# Create virtual environment
uv venv
# Activate virtual environment
source .venv/bin/activate # macOS/Linux
# OR
.venv\Scripts\activate # Windows
# Install dependencies
uv pip install -e .
3. Configure environment variables
Create a .env file in the project root:
PROTON_USERNAME=your-email@protonmail.com
PROTON_PASSWORD=your-password
PROTON_PGP_PASSWORD=your-pgp-passphrase-if-needed
⚠️ Important: Never commit your .env file to version control!
4. Test the server
# Run with MCP inspector for testing
uv run mcp dev protonmail_server.py
# Or test directly
uv run python protonmail_server.py
Usage with Claude Desktop
Configure Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"protonmail": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/protonmail-mcp-connector",
"run",
"protonmail_server.py"
]
}
}
}
Replace /absolute/path/to/protonmail-mcp-connector with the actual path to this directory.
Restart Claude Desktop
After updating the configuration, restart Claude Desktop to load the ProtonMail connector.
Available Tools
list_messages
List recent messages from your inbox.
Example:
List my last 10 emails
read_message
Read the full content of a specific message.
Example:
Read message ID abc123
send_email
Send an email via ProtonMail.
Example:
Send an email to john@example.com with subject "Meeting Tomorrow"
and body "Hi John, let's meet at 2pm tomorrow."
search_email
Search for emails matching a query.
Example:
Search for emails about "project update"
Troubleshooting
Authentication Issues
If you're experiencing authentication issues:
-
CAPTCHA Protection: ProtonMail may require CAPTCHA verification. To bypass:
- Log into your account via web browser 10+ times
- Complete any CAPTCHAs that appear
- Your account will be allowlisted for API access
-
Two-Factor Authentication: If you have 2FA enabled, you may need to use an app-specific password
-
Session Expired: Delete the
proton_session.picklefile and re-authenticate
Connection Errors
- Ensure your credentials in
.envare correct - Check your internet connection
- Verify ProtonMail service status
Claude Desktop Not Detecting the Server
- Verify the path in
claude_desktop_config.jsonis absolute (not relative) - Ensure the virtual environment is created (
uv venv) - Check Claude Desktop logs for error messages
- Restart Claude Desktop after configuration changes
Project Structure
protonmail-mcp-connector/
├── .env # Environment variables (create this)
├── .gitignore # Git ignore file
├── README.md # This file
├── pyproject.toml # Python project configuration
├── protonmail_client.py # ProtonMail API wrapper
├── protonmail_server.py # MCP server implementation
└── requirements.txt # Python dependencies
Development
Running Tests
# Run the MCP inspector
uv run mcp dev protonmail_server.py
Adding New Features
To add new tools:
- Add methods to
ProtonMailClientclass inprotonmail_client.py - Create corresponding
@mcp.tool()decorated functions inprotonmail_server.py - Document the new tool in this README
Security Considerations
- Never commit your
.envfile orproton_session.pickleto version control - Store credentials securely
- The session file contains authentication tokens - protect it like a password
- Use app-specific passwords if available
- Consider using a dedicated ProtonMail account for API access
Limitations
- This is an unofficial ProtonMail client using reverse-engineered APIs
- ProtonMail may rate-limit or block API access
- Some ProtonMail features may not be available
- Attachments support is limited in the current version
- No official support from ProtonMail
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
License
MIT License - see LICENSE file for details
Acknowledgments
- Built with MCP Python SDK
- Uses protonmail-api-client
- Inspired by the Model Context Protocol community
Disclaimer
This project is not affiliated with, endorsed by, or sponsored by Proton AG. Use at your own risk.