# simplelogin-mcp

> simplelogin-mcp is an open-source MCP server for security. Manage SimpleLogin aliases, mailboxes, domains and settings from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://simplelogin-mcp.com
- **Repository:** https://github.com/enthouan/simplelogin-mcp
- **MCP Registry name:** io.github.enthouan/simplelogin-mcp
- **Categories:** security, productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

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