Skip to content
MCP server

simplelogin-mcp

Manage SimpleLogin aliases, mailboxes, domains and settings from an MCP client

Runs locallyStatus and history
Install
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.5

Add 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.Required
  • SL_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  3. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security