# simplelogin-mcp

> An independent, self-hostable MCP server for existing SimpleLogin users. It is not affiliated with, endorsed by, or sponsored by SimpleLogin or Proton AG.

simplelogin-mcp lets an MCP client manage aliases, contacts, mailboxes, custom domains, notifications, and account settings through the SimpleLogin API. It runs locally over stdio or as a Streamable HTTP service. The server reads the SimpleLogin API key from its environment and sends it only to the configured SimpleLogin API origin; the key must never be placed in a prompt.

## Documentation

- [Manage SimpleLogin from your MCP client.](https://simplelogin-mcp.com/): An independent MCP server for existing SimpleLogin users to create aliases, inspect alias activity metadata, manage routing, and use reverse aliases.
- [Install and run](https://simplelogin-mcp.com/getting-started/): Create an API key, prepare the server, configure your MCP client, then verify the connection.
- [Set up your MCP client](https://simplelogin-mcp.com/getting-started/clients/): Connect Codex, Claude, VS Code, or OpenCode over local stdio or Streamable HTTP.
- [Client compatibility](https://simplelogin-mcp.com/getting-started/compatibility/): Compatibility routes and the evidence currently available for each MCP client setup.
- [Docker Compose — Streamable HTTP](https://simplelogin-mcp.com/getting-started/docker/): Run simplelogin-mcp as a loopback-published Compose service.
- [Direct Node.js — Streamable HTTP](https://simplelogin-mcp.com/getting-started/http/): Run the Node.js server directly on loopback and connect an HTTP MCP client.
- [Get a SimpleLogin API key](https://simplelogin-mcp.com/getting-started/simplelogin-api-key/): Create a dedicated SimpleLogin API key, store it as SL_API_KEY, verify it safely, and rotate or revoke it.
- [Local stdio](https://simplelogin-mcp.com/getting-started/stdio/): Let a local desktop MCP client launch simplelogin-mcp as a child process.
- [FAQ](https://simplelogin-mcp.com/guides/faq/): Project scope, privacy, hosting, credentials, plans, and when to use SimpleLogin directly.
- [How it works](https://simplelogin-mcp.com/guides/how-it-works/): Follow a tool call from your MCP client through simplelogin-mcp to the SimpleLogin API and back.
- [Operate simplelogin-mcp](https://simplelogin-mcp.com/guides/operations/): Inspect, upgrade, roll back, stop, and rotate credentials for a running simplelogin-mcp deployment.
- [Security & Data](https://simplelogin-mcp.com/guides/security/): Understand how simplelogin-mcp handles credentials, requests, transports, network exposure, and account-changing tools.
- [Troubleshooting](https://simplelogin-mcp.com/guides/troubleshooting/): Diagnose startup, transport, authentication, Docker, and SimpleLogin API failures safely.
- [Workflows](https://simplelogin-mcp.com/guides/workflows/): Follow practical SimpleLogin workflows expressed through the MCP tool catalog.
- [Reference](https://simplelogin-mcp.com/reference/): Technical reference, contribution guidance, issue reporting, and security policies for simplelogin-mcp.
- [API coverage](https://simplelogin-mcp.com/reference/api-coverage/): Supported, deferred, and intentionally excluded areas of the SimpleLogin API.
- [Configuration](https://simplelogin-mcp.com/reference/configuration/): Reference every simplelogin-mcp environment variable, its default, and the boundary it controls.
- [Contributing](https://simplelogin-mcp.com/reference/contributing/): Set up simplelogin-mcp locally, make focused changes, and validate them without exposing credentials.
- [Reporting issues and support](https://simplelogin-mcp.com/reference/reporting-issues/): Choose the right support channel and prepare a safe, reproducible simplelogin-mcp report.
- [Security policy](https://simplelogin-mcp.com/reference/security-policy/): Supported versions, private vulnerability reporting, and the information to include in a report.
- [Tool catalog](https://simplelogin-mcp.com/reference/tools/): Search the complete catalog-backed SimpleLogin MCP tool reference.

## Source

- [GitHub repository](https://github.com/enthouan/simplelogin-mcp)
- [SimpleLogin](https://simplelogin.io/)