# smbCloud Mail & Auth

An MCP server that connects agents to email and auth infrastructure: domains, inbox routing, auth apps and deploys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: smbcloudXYZ
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/smbcloudXYZ/smbcloud-cli
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/smbcloud-mail-auth

## What it does

smbCloud Mail & Auth wires an agent into smbCloud's services, covering domain management, inbox routing rules, auth app configuration and deploys without leaving the chat.

It can be reached over HTTP at `https://api.smbcloud.xyz/v1/mcp` or run locally via `npx -y @smbcloud/cli`. The local stdio setup needs an `SMB_MAIL_API_KEY` environment variable, and skipping it leaves the server unable to start.

Configs exist for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed and Gemini CLI, each with its own setup block.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.smbcloud.xyz/v1/mcp`
- Environment variables: `SMB_MAIL_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> --transport stdio smbcloud-mail-auth -- npx -y @smbcloud/cli
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add smbcloud-mail-auth --url https://api.smbcloud.xyz/v1/mcp
```

2. **Platform CLI**
```bash
codex mcp add smbcloud-mail-auth --env SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> -- npx -y @smbcloud/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "url": "https://api.smbcloud.xyz/v1/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "command": "npx",
            "args": [
                "-y",
                "@smbcloud/cli"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<SMB_MAIL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "smbcloud-mail-auth": {
            "type": "http",
            "url": "https://api.smbcloud.xyz/v1/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "smbcloud-mail-auth": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@smbcloud/cli"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<SMB_MAIL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http smbcloud-mail-auth https://api.smbcloud.xyz/v1/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> smbcloud-mail-auth npx -y @smbcloud/cli
```
Replace <…> with your own values

## When to use it
- set up a domain and inbox routing rules from the agent
- wire up an auth app without opening the smbCloud console
- trigger a deploy for mail infrastructure changes
- manage several mail domains from one place

## Example prompts
- List the domains connected through smbCloud Mail & Auth
- Set up inbox routing for example.com
- Deploy the latest auth app changes through smbcloud-mail-auth

## Similar
- [Faable — Deploy & Auth](https://affpapa.org/en/nevibecode/mcp/faable-deploy-auth.md) — MCP server · ★ 1
- [better-auth-security-best-practices](https://affpapa.org/en/nevibecode/skills/better-auth-security-best-practices.md) — skill · 48000 installs
- [neon-auth](https://affpapa.org/en/nevibecode/skills/neon-auth.md) — skill · 20300 installs
- [auth-implementation-patterns](https://affpapa.org/en/nevibecode/skills/auth-implementation-patterns.md) — skill · 19388 installs
- [api-auth-key-management](https://affpapa.org/en/nevibecode/skills/api-auth-key-management.md) — skill · 7800 installs
- [api-auth-and-jwt-abuse](https://affpapa.org/en/nevibecode/skills/api-auth-and-jwt-abuse.md) — skill · 3800 installs

From the same set: [smbcloudxyz/smbcloud-cli](https://affpapa.org/en/nevibecode/by/smbcloudxyz/smbcloud-cli.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md