simplelogin-mcp server

simplelogin-mcp

An independent, self-hostable Model Context Protocol server for existing SimpleLogin users. It lets compatible MCP clients create and manage aliases, inspect alias activity metadata, work with reverse aliases, manage routing, and review account settings through a server you run.

Independent project: simplelogin-mcp is an independent, open-source project. It is not an

official SimpleLogin or Proton AG product, service, or MCP implementation, and it is not

affiliated with, endorsed by, or sponsored by SimpleLogin or Proton AG.

At a glance

client launches the server without opening a network listener.

• Local stdio is the simplest starting point for one local MCP client. The

service for HTTP-capable MCP clients, listening on loopback by default.

• Direct Node.js — Streamable HTTP runs a persistent

prefer to manage the service with Docker, with loopback-only host publishing by default.

• Docker Compose — Streamable HTTP runs the published container when you

history, and version control.

• SLAPIKEY grants full control of your SimpleLogin account. Keep it out of prompts, logs, shell

catalog and schemas used by the server.

• Tool names, inputs, safety annotations, bounds, and output descriptions come from the same

Documentation

The website is the canonical user documentation:

• Get started
• Create a SimpleLogin API key
• Set up your MCP client
• Browse the tool catalog
• Review API coverage and non-goals
• Understand Security & Data
• Operate a running deployment
• Troubleshoot an installation
• View the published container package

Repository-maintainer documentation remains alongside the code:

• Live smoke-test runbook
• Registry readiness
• Release process
• Contributing guide
• Support policy
• Vulnerability reporting

Tools

The catalog covers aliases, contacts and reverse aliases, mailboxes, custom domains, notifications, and account settings. Read operations with potentially large results are bounded, and permanent deletions require explicit confirmation.

Use the searchable website tool catalog for the current public surface, or read the generated TOOL_CATALOG.md beside the source. Endpoint-level support and deliberate non-goals are documented in API coverage.

Common workflows

The workflow guide provides complete, reviewable sequences. These summaries preserve the most common entry points.

Create and organize aliases

Use aliaslist to find existing aliases before creating one with aliascreaterandom. For a custom address, inspect aliasoptionsget before calling aliascreatecustom. Use aliasupdate to keep notes, names, and pinned state organized, and aliassetenabled to enable or disable an alias explicitly.

For a personal example of how I organize my SimpleLogin aliases, read How I organize my email.

Audit recent alias activity

Shortened. The full README is on GitHub.