# smbCloud Mail & Auth

> smbCloud Mail & Auth is an open-source MCP server for developer tools. Manage email domains, inbox routes, auth apps and deploys from an agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, API
- **Website:** https://docs.smbcloud.xyz/developer/cli
- **Repository:** https://github.com/smbcloudxyz/smbcloud-cli
- **MCP Registry name:** io.github.smbcloudXYZ/smbcloud-cli
- **Categories:** developer tools, cloud and infrastructure, communication
- **Listing updated:** 2026-11-14

## About

smbCloud ships one Rust binary, smb, that is also an MCP server: running smb --mcp serves the same operations over stdio, and a hosted endpoint is listed at api.smbcloud.xyz/v1/mcp. The docs say it covers projects, tenants, Mail, Auth apps, simulators and ControlKit runners, so a person, a CI job and an agent run the same commands against one account.

Email sending uses a separate Mail app key (SMB_MAIL_API_KEY) for the mail_send tool, while every other tool uses the session from smb login. An account is required for deploy and init. With --scope automation the server also exposes Xcode, ControlKit, CoreDevice and adb tools for mobile and TV automation.

Install through Homebrew, npm, Cargo or pip. The CLI is Apache-2.0 and distributed by Splitfire AB.

## Features

- **Mail and domains:** Manage smbCloud Mail, including domains and inbox routes.
- **Auth apps:** Create and manage smbCloud Auth apps from the terminal or an agent.
- **Deploy from CLI:** smb login, init and deploy take a project from login to first deploy.
- **CI mode:** --ci disables prompts so missing answers fail fast.
- **Automation scope:** --scope automation adds Xcode, ControlKit, CoreDevice and adb tools.
- **Several install channels:** Homebrew, npm, Cargo and PyPI deliver the same binary.

## Good for

- Let an agent configure an inbox route for a new domain
- Deploy a project from GitHub Actions
- Create an auth app for a new project
- Drive iOS or Android test runners from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.smbcloud.xyz/v1/mcp
```

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

```json
{
  "mcpServers": {
    "smbcloud-cli": {
      "url": "https://api.smbcloud.xyz/v1/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "smbcloud-cli": {
      "type": "http",
      "url": "https://api.smbcloud.xyz/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "smbcloud-cli": {
      "serverUrl": "https://api.smbcloud.xyz/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "smbcloud-cli": {
      "type": "http",
      "url": "https://api.smbcloud.xyz/v1/mcp"
    }
  }
}
```

## Tools

- `mail_send`: Sends email using a Mail app API key.

## FAQ

### How do I start the MCP server?

Run smb --mcp for stdio, or use the hosted URL https://api.smbcloud.xyz/v1/mcp.

### What credentials does it need?

A smb login session for most tools, and a Mail app key for mail_send.

### What licence is it under?

Apache-2.0.

### Does it work in CI?

Yes, smb --ci runs non-interactively.

### Is smbCloud Mail & Auth free?

Yes. smbCloud Mail & Auth is open source, so you can use and self-host it for free.

### How do I add smbCloud Mail & Auth to Claude Code?

Run this command in your terminal: claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcp

### What are the best alternatives to smbCloud Mail & Auth?

The closest alternatives to smbCloud Mail & Auth are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/smbcloud-mail-and-auth
