simplelogin-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SIMPLELOGIN_API_KEY | No | SimpleLogin API key. Can be exported directly instead of using the 1Password wrapper. | |
| SIMPLELOGIN_OP_ITEM | No | 1Password item ID holding the SimpleLogin API key, used by the recommended bin/simplelogin-mcp launcher. | |
| SIMPLELOGIN_API_BASE | No | Optional override for the SimpleLogin API base URL, useful for a local mock. | https://api.simplelogin.io/api |
| SIMPLELOGIN_OP_VAULT | No | 1Password vault name for the SimpleLogin API key item. | Hermes Agent |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Manage email aliases through the SimpleLogin API.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sl_whoamiA | Check the configured API key and return the SimpleLogin account email. |
| sl_list_aliasesC | List aliases (newest first), optionally filtered by a search query. |
| sl_get_aliasB | Get one SimpleLogin alias by numeric ID. |
| sl_alias_optionsA | Get the signed suffixes and mailboxes available for creating a custom alias. Pass hostname (e.g. 'example.com') for a site-specific suffix. |
| sl_create_aliasC | Create a new random alias. note is a label for your own use. |
| sl_create_custom_aliasB | Create a custom alias with a chosen prefix. Get signed_suffix and mailbox_ids from sl_alias_options first. |
| sl_update_aliasC | Update the note and/or name of an existing SimpleLogin alias. |
| sl_toggle_aliasB | Flip a SimpleLogin alias between enabled and disabled by ID. |
| sl_delete_aliasA | Delete a SimpleLogin alias by ID. This cannot be undone. |
| sl_list_mailboxesB | List the mailboxes available for SimpleLogin aliases. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool maps to a distinct action on aliases or mailboxes, and the create_alias (random) vs create_custom_alias (chosen prefix) split is explicitly documented. Minor overlap remains between sl_alias_options and sl_list_mailboxes, since alias options returns mailbox IDs and mailboxes are listed separately, which could cause a selection fumble.
All names use a consistent sl_ prefix and snake_case with verb_noun form (sl_create_alias, sl_list_aliases, sl_delete_alias). A few deviate into noun-only or idiosyncratic forms (sl_alias_options, sl_whoami), but the pattern remains readable and predictable.
Ten tools is well within the ideal range, and each one earns its place: CRUD on aliases, a toggle, an options helper, a mailbox listing, and an auth check. No redundant or filler tools are present.
The alias lifecycle is fully covered with list, get, create (random and custom), update, toggle, and delete, plus discovery helpers and authentication verification. Gaps exist around mailbox management (creation/deletion) and alias contacts/notes-level operations, but the core workflow is closed.