smbCloud Mail & Auth — Claude Code MCP server: what it does
An MCP server that connects agents to email and auth infrastructure: domains, inbox routing, auth apps and deploys.
claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcpWhat smbCloud Mail & Auth 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.
What it helps with
- 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 for the agent
- 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
How to install smbCloud Mail & Auth
1Platform CLI: remote server
claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcp2Platform CLI
claude mcp add --env SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> --transport stdio smbcloud-mail-auth -- npx -y @smbcloud/cliReplace <…> with your own values
1Platform CLI: remote server
codex mcp add smbcloud-mail-auth --url https://api.smbcloud.xyz/v1/mcp2Platform CLI
codex mcp add smbcloud-mail-auth --env SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> -- npx -y @smbcloud/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"smbcloud-mail-auth": {
"url": "https://api.smbcloud.xyz/v1/mcp"
}
}
}{
"mcpServers": {
"smbcloud-mail-auth": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"env": {
"SMB_MAIL_API_KEY": "<SMB_MAIL_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"smbcloud-mail-auth": {
"type": "http",
"url": "https://api.smbcloud.xyz/v1/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http smbcloud-mail-auth https://api.smbcloud.xyz/v1/mcp2Platform CLI
gemini mcp add -e SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> smbcloud-mail-auth npx -y @smbcloud/cliReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about smbCloud Mail & Auth
How do I install smbCloud Mail & Auth in Claude Code?
Run claude mcp add --transport http smbcloud-cli https://api.smbcloud.xyz/v1/mcp, then claude mcp add --transport http smbcloud-mail-auth https://api.smbcloud.xyz/v1/mcp, and finally claude mcp add --env SMB_MAIL_API_KEY=<SMB_MAIL_API_KEY> --transport stdio smbcloud-mail-auth -- npx -y @smbcloud/cli.
What does smbCloud Mail & Auth do?
It's an MCP server that gives an agent access to email and auth infrastructure: domains, inbox routes, auth apps and deploys.
What's needed to run it locally?
The stdio setup via npx -y @smbcloud/cli requires an SMB_MAIL_API_KEY environment variable, without which the server won't start.
