simplelogin-mcp
Manage SimpleLogin aliases, mailboxes, domains and settings from an MCP client
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.5
- Listing updated
- 2 days ago
About simplelogin-mcp
simplelogin-mcp is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.
This is an independent project, not an official SimpleLogin or Proton product. It offers 27 catalogue-backed tools for SimpleLogin accounts, covering aliases, contacts and reverse aliases, mailboxes, custom domains and settings. Activity tools return metadata for forwards, replies, blocks and bounces, not message bodies, and it does not compose or send email.
It reads SL_API_KEY from the environment and never puts it into MCP messages, though that key grants full control of the account. Tools that can stop delivery or delete data are labelled Destructive, and permanent deletion needs confirm: true. It runs over local stdio or Streamable HTTP on loopback, with a container image. Some capabilities depend on your SimpleLogin plan.
Install
Run in a terminal
claude mcp add simplelogin-mcp --env SL_API_KEY='<SL_API_KEY>' -- docker run -i --rm -e SL_API_KEY ghcr.io/enthouan/simplelogin-mcp:1.0.5Add to claude_desktop_config.json
{
"mcpServers": {
"simplelogin-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SL_API_KEY",
"ghcr.io/enthouan/simplelogin-mcp:1.0.5"
],
"env": {
"SL_API_KEY": "<SL_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"simplelogin-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SL_API_KEY",
"ghcr.io/enthouan/simplelogin-mcp:1.0.5"
],
"env": {
"SL_API_KEY": "<SL_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"simplelogin-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SL_API_KEY",
"ghcr.io/enthouan/simplelogin-mcp:1.0.5"
],
"env": {
"SL_API_KEY": "<SL_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"simplelogin-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SL_API_KEY",
"ghcr.io/enthouan/simplelogin-mcp:1.0.5"
],
"env": {
"SL_API_KEY": "<SL_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"simplelogin-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SL_API_KEY",
"ghcr.io/enthouan/simplelogin-mcp:1.0.5"
],
"env": {
"SL_API_KEY": "<SL_API_KEY>"
}
}
}
}Configuration
TRANSPORTRun the container as an MCP stdio server.SL_API_KEYSimpleLogin API key created from Settings -> API Keys.RequiredSL_API_URLSimpleLogin web app origin for app.simplelogin.io or a self-hosted instance.SL_REQUEST_TIMEOUT_MSPer-request timeout to the SimpleLogin API, in milliseconds.
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- alias_list
- Lists aliases.
- alias_get
- Gets one alias.
- alias_create_random
- Creates a random alias with the account's default style.
- alias_options_get
- Shows options before creating a custom alias.
- alias_create_custom
- Creates a custom alias.
- alias_update
- Updates notes, name and pinned state.
- alias_set_enabled
- Enables or disables an alias.
- alias_activity_list
- Pages through alias activity metadata.
- contact_list
- Lists contacts.
- contact_create
- Creates or reuses a reverse alias.
- mailbox_list
- Lists mailboxes.
- custom_domain_list
- Lists custom domains.
- settings_get
- Reads account settings.
- settings_update
- Changes supported settings.
What it does
- Alias management
- Create random or custom aliases, update and enable or disable.
- Activity review
- Metadata for forwards, replies, blocks and bounces.
- Reverse aliases
- Create or reuse for a recipient.
- Delete guards
- Permanent deletion requires confirm: true.
- Self-hostable
- Node.js or container; loopback by default.
Good for
- Create an alias for a signup
- Audit recent alias activity
- Review mailbox verification
- Change account-wide alias settings
Pricing
Open source
Open source; requires a SimpleLogin account
Prices change. Check simplelogin-mcp.com before you buy.
simplelogin-mcp FAQ
Is it official?
No, independent.
What does it need?
A SimpleLogin API key.
Does it read email?
No.
Which plan features?
Some depend on your SimpleLogin plan.
Is simplelogin-mcp free?
Yes. simplelogin-mcp is open source, so you can use and self-host it for free.
How do I add simplelogin-mcp to Claude Code?
Run this command in your terminal: claude mcp add simplelogin-mcp --env SL_API_KEY='<SL_API_KEY>' -- docker run -i --rm -e SL_API_KEY ghcr.io/enthouan/simplelogin-mcp:1.0.5
What are the best alternatives to simplelogin-mcp?
The closest alternatives to simplelogin-mcp are REA, Ha MCP, Concord MCP, Agent Roast and Midplane.
Alternatives to simplelogin-mcp

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security