# Waypost: Proton tools for your agent.

> Waypost connects AI agents to Proton Mail, Drive and Calendar through a local CLI and MCP server. Reading is the default; sending and uploading stay off until you allow them, and every write needs confirmation.

By Donovan Baney (@baney75). Page: https://dbaney.com/projects/waypost/

- **Price:** Free
- **Status:** Version 0.4.1
- **Runs on:** macOS and Linux with Node.js 22.14 or newer (Windows not yet verified)
- **Built with:** TypeScript, Node.js, MCP
- **License:** MIT
- **Source:** https://github.com/baney75/waypost
- **Live:** https://baney75.github.io/waypost/docs/
- **Documentation:** https://dbaney.com/projects/waypost/docs/ (Markdown: https://dbaney.com/projects/waypost/docs.md)

## Why I built it

I use Proton for mail, files and calendar, and I wanted my agents to help with them the same way they help with everything else. I built Waypost to connect agents to Proton tools without ever handling my Proton password.

## Careful by default

Waypost reads mail through Proton Mail Bridge, reaches Drive through Proton's official CLI, and works with Calendar through exports and share links. Mail and Calendar are read-only by default. Sending mail and uploading files start disabled, and when you turn them on, every single call still has to confirm. There is no permanent-delete or public-sharing tool at all.

## One tool, two doors

The CLI and the MCP server share the same tools and the same JSON results, so a script and an agent see exactly the same thing. Errors say what to run or change next.

## Read by default, write only when you say so

- Read Proton Mail locally through Bridge or a read-only helper - folders, search, messages, threads and attachments.
- List, inspect and download Proton Drive files through Proton's official CLI, with checksum checks.
- Read Calendar exports and prepare ICS files, including recurring and all-day events.
- Sending and uploads start disabled and need confirmation on every call.
- The same tools from the command line or any MCP client, with no network listener.

## Limits

Calendar imports must be saved and verified in Proton. Waypost is independent of Proton.

## Questions and answers

### What is Waypost?

Waypost connects AI agents to Proton Mail, Drive and Calendar through a local CLI and MCP server. Reading is the default; sending and uploading stay off until you allow them, and every write needs confirmation.

### Is Waypost free?

Yes. Waypost costs nothing, and its source code is on GitHub under the MIT license.

### How do I install Waypost?

Clone the repository and build it with Node.js 22.14 or newer, then register the MCP server with Claude Code or another MCP client. The documentation lists each command.

### What does Waypost run on?

macOS and Linux with Node.js 22.14 or newer; Windows is not verified yet. Mail goes through Proton Mail Bridge and Drive through Proton's official CLI.

### Does Waypost see my Proton password?

No. It reads mail through Proton Mail Bridge and reaches Drive through Proton's official CLI. It runs on your computer and opens no network listener. Sending mail and uploading files start disabled, and every call must still be confirmed once you turn them on.

### Does Waypost have limits?

Calendar imports must be saved and verified in Proton. Waypost is independent of Proton.

## Related projects

- [Stillport](https://dbaney.com/projects/stillport/): Stillport gives AI agents a CLI and an MCP server for Apple Photos, Google Photos Picker and local Google Takeout archives. Search natively, inspect metadata, and export only what the agent needs to see.
- [VaultLink](https://dbaney.com/projects/vaultlink/): VaultLink opens an Obsidian vault in a browser or Chrome side panel, reached from your other devices over private Tailscale and protected by a pairing token.
- [BaneySpaces](https://dbaney.com/projects/baneyspaces/): A free Mac workspace manager. Press ⌘1–⌘9 to switch spaces instantly, add Shift to move a window, and open a Deck of terminals and coding agents. Agents get a workspace of their own so automation stays out of your way.