Protonlite
Unofficial Python client and MCP server for Proton Mail, Calendar, Contacts and Drive
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.1.3
- Listing updated
- today
Similar MCP servers
About Protonlite
Protonlite is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Protonlite exists because Proton offers no IMAP or SMTP and its official route, Mail Bridge, needs a paid plan. This project talks to Proton's web API directly, so it works on a free account, with end-to-end crypto ported from Proton's own MIT-licensed Go libraries. It is unofficial, relies on an undocumented API that can change, and may be subject to Proton's terms, so the README advises using it only on accounts you own.
Sign-in happens once through the CLI, which saves a session file; the MCP server reuses that file and never takes a password. Proton usually asks for a human verification page, and the project surfaces that URL for a person to complete rather than solving it. TOTP two-factor is supported.
The server exposes 18 tools covering mail, calendar, contacts and Drive, and wraps other people's content as untrusted data. Sending is governed by a recipient allowlist and an optional confirm-before-send rule.
Install
Run in a terminal
claude mcp add protonlite --env PROTONLITE_SESSION='<PROTONLITE_SESSION>' -- uvx protonliteAdd to claude_desktop_config.json
{
"mcpServers": {
"protonlite": {
"command": "uvx",
"args": [
"protonlite"
],
"env": {
"PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"protonlite": {
"command": "uvx",
"args": [
"protonlite"
],
"env": {
"PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"protonlite": {
"type": "stdio",
"command": "uvx",
"args": [
"protonlite"
],
"env": {
"PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"protonlite": {
"command": "uvx",
"args": [
"protonlite"
],
"env": {
"PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"protonlite": {
"command": "uvx",
"args": [
"protonlite"
],
"env": {
"PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PROTONLITE_SESSIONPath to the session file saved by `protonlite login`. The server reuses it and never takes a password.Required
Tools this server provides (18)
Taken from the project documentation; the running server may differ.
- list_messages
- Lists messages in the inbox or a folder.
- read_message
- Reads and decrypts a message.
- search_messages
- Searches mail.
- send_message
- Sends mail, governed by the send policy.
- calendar
- Reads and edits calendar events.
- contacts
- Reads and edits contacts.
- drive_list
- Lists Drive folders.
- drive_download
- Downloads a Drive file.
- drive_upload
- Uploads an encrypted file.
- drive_mkdir
- Creates a Drive folder.
- drive_move
- Moves a Drive item.
- drive_rename
- Renames a Drive item.
- drive_trash
- Moves a Drive item to trash.
- drive_share_link
- Creates a public share link.
- drive_unshare_link
- Removes a public share link.
- email_policy_status
- Shows the send allowlist and confirmation setting.
- email_allow
- Sets the recipient allowlist.
- set_send_confirmation
- Turns confirm-before-send on or off.
What it does
- Free-account access
- Works without Proton Mail Bridge or a paid plan.
- Local decryption
- Keys are unlocked locally and content is decrypted on your machine.
- Mail, calendar, contacts, Drive
- Read, search, send, schedule events, manage contacts and files.
- Send policy
- A recipient allowlist and optional confirmation before sending.
- Session reuse
- The server uses a saved session file and never takes a password.
- Multiple accounts
- Independent sessions for personal and work mailboxes.
Good for
- Have an agent triage unread Proton mail
- Draft and send replies with allowlisted recipients
- Add and edit calendar events and invitations
- Upload files to Drive and create a public share link
Pricing
Open source
MIT licence; free Python package
Protonlite FAQ
Does it need a paid Proton plan?
No. It uses Proton's web API, so a free account works.
Is it official?
No. It is not affiliated with or supported by Proton AG, and the API can change.
How does the server sign in?
Run protonlite login once, then point PROTONLITE_SESSION at the saved session file.
Which licence does it use?
MIT.
Is Protonlite free?
Yes. Protonlite is open source, so you can use and self-host it for free.
How do I add Protonlite to Claude Code?
Run this command in your terminal: claude mcp add protonlite --env PROTONLITE_SESSION='<PROTONLITE_SESSION>' -- uvx protonlite
What are the best alternatives to Protonlite?
The closest alternatives to Protonlite are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

