# Protonlite

> Protonlite is an open-source MCP server for communication. Unofficial Python client and MCP server for Proton Mail, Calendar, Contacts and Drive. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/maytrella007/protonlite
- **MCP Registry name:** io.github.Maytrella007/protonlite
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add protonlite --env PROTONLITE_SESSION='<PROTONLITE_SESSION>' -- uvx protonlite
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "protonlite": {
      "command": "uvx",
      "args": [
        "protonlite"
      ],
      "env": {
        "PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "protonlite": {
      "command": "uvx",
      "args": [
        "protonlite"
      ],
      "env": {
        "PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "protonlite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "protonlite"
      ],
      "env": {
        "PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "protonlite": {
      "command": "uvx",
      "args": [
        "protonlite"
      ],
      "env": {
        "PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "protonlite": {
      "command": "uvx",
      "args": [
        "protonlite"
      ],
      "env": {
        "PROTONLITE_SESSION": "<PROTONLITE_SESSION>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/protonlite
