Skip to content
MCP server

Protonlite

Unofficial Python client and MCP server for Proton Mail, Calendar, Contacts and Drive

Runs locallyStatus and history
Install
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 protonlite

Add 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.

How AIPoweredBot checks servers