smbCloud MCP server

Q: How do I add smbCloud MCP to Claude Code?

Run `claude mcp add --env 'SMB_MAIL_API_KEY= ' smbcloud-cli -- npx -y @smbcloud/cli` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add smbCloud MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Q: How do I use smbCloud in a CI/CD environment?

Use the `--ci` flag to disable interactive prompts, ensuring that missing answers cause the process to fail immediately rather than hanging.

✓ VerifiedCommit Nov 13, 2026

smbcloudxyz/smbcloud-cli · rust

Manages email infrastructure, authentication, and deployments through a command-line interface and MCP server.

Also known as smbcloudXYZ/smbcloud-cli, smbcloud-cli, @smbcloud/cli

stdio remote Developer Tools

Install GitHub ↗

Stars: 12
Tools: —
Downloads, 30 days: —
Latest version: 1.2.0
Last commit: Nov 13, 2026
License: —

What is smbCloud MCP?

smbCloud manages email infrastructure, authentication, and deployments through a command-line interface and MCP server.

Summary generated from the project's README

About smbCloud MCP server

Managing email infrastructure, authentication, and deployments through an AI agent is what smbCloud Mail & Auth enables. This MCP server allows developers to interact with smbCloud capabilities like Mail, Auth, Deploy, and GresIQ without needing a web browser. It functions by serving the Model Context Protocol over stdio, making it accessible to AI clients that support the protocol.

Users can integrate these operations into their workflows using the same commands used in the smb binary or via the REST API. The server is designed to work for people at a terminal, CI jobs, and AI agents alike. It supports specialized automation through the --mcp --scope automation flag, which exposes tools such as Xcode, ControlKit, CoreDevice, and adb for mobile and TV automation tasks.

What you can do with it

1Automated infrastructure deploymentAn AI agent can handle the entire process from logging in to performing a first deployment.
2Mobile and TV automationDevelopers can use the server to control mobile devices and TV hardware via specific automation scopes.
3Continuous Integration workflowsYou can run smbCloud operations in automated environments where interactive prompts are not possible.

Written from the project's README. Every use case is checked against a quote from it.

How to install smbCloud MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli -- npx -y @smbcloud/cli

~/.cursor/mcp.json

{
  "mcpServers": {
    "smbcloud-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smbcloud/cli"
      ],
      "env": {
        "SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "smbcloud-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smbcloud/cli"
      ],
      "env": {
        "SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
      }
    }
  }
}

$ code --add-mcp '{"name":"smbcloud-cli","type":"stdio","command":"npx","args":["-y","@smbcloud/cli"],"env":{"SMB_MAIL_API_KEY":"<YOUR_SMB_MAIL_API_KEY>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "smbcloud-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smbcloud/cli"
      ],
      "env": {
        "SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
      }
    }
  }
}

$ codex mcp add smbcloud-cli --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' -- npx -y @smbcloud/cli

~/.codex/config.toml

[mcp_servers.smbcloud-cli]
command = "npx"
args = ["-y", "@smbcloud/cli"]

[mcp_servers.smbcloud-cli.env]
SMB_MAIL_API_KEY = "<YOUR_SMB_MAIL_API_KEY>"

$ gemini mcp add -s user -e 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli npx -- -y @smbcloud/cli

~/.gemini/settings.json

{
  "mcpServers": {
    "smbcloud-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smbcloud/cli"
      ],
      "env": {
        "SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
      }
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

SMB_MAIL_API_KEYSecret
Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.

Name	Description
SMB_MAIL_API_KEY	Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.	Secret

Automated checks

Ran Nov 13, 2026Full report →

89/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)No licenseFinding
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

Every smbCloud capability works without a browser. You reach it through the REST API first, then through smb, then through its MCP server, and each one covers the same operations. smb is one binary with no runtime to install, so a person at a terminal, a CI job and an AI agent all run the same commands against the same account.

Install

brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap && brew install cli
npm install -g @smbcloud/cli
cargo install smbcloud-cli

More ways, including .NET, pip, shell, PowerShell and pre-built binaries, are in docs/install.md.

Use it your way

In the terminal. smb login && smb init && smb deploy takes you from a fresh login to a first deploy. See interfaces.
In scripts and CI. smb --ci turns off prompts, so a missing answer fails fast instead of hanging. See CI mode.
With AI agents. smb --mcp serves the Model Context Protocol over stdio, and it is listed in the MCP Registry as io.github.smbcloudXYZ/smbcloud-cli. See MCP.
For mobile and TV automation. smb --mcp --scope automation exposes Xcode, ControlKit, CoreDevice and adb tools. See ControlKit.

Docs

Install, interfaces, CI, MCP, MCP Registry, ControlKit, AndroidKit, development. The index is docs/README.md.

Contributing

Read CONTRIBUTING.md to get started. Contributions are welcome.

License

Apache-2.0

Copyright

Read full README

smbCloud MCP questions

How do I add smbCloud MCP to Claude Code?

Run claude mcp add --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli -- npx -y @smbcloud/cli in your terminal. Add --scope user to make it available in every project.

How do I add smbCloud MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Does smbCloud require a browser to function?

No, every smbCloud capability is accessible without a browser via the REST API, the CLI, or the MCP server.

How do I use smbCloud in a CI/CD environment?

Use the --ci flag to disable interactive prompts, ensuring that missing answers cause the process to fail immediately rather than hanging.

Facts

Nov 14, 2026

Stars: 12
Downloads, 30 days: —
Latest version: 1.2.0
Last commit: Nov 13, 2026
License: —
Transport: stdio, remote
Package: @smbcloud/cli

smbcloudXYZ ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/smbcloudxyz/smbcloud-cli.svg)](https://hostedmcp.org/servers/smbcloudxyz/smbcloud-cli/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

smbCloud MCP server

What is smbCloud MCP?

About smbCloud MCP server

What you can do with it

How to install smbCloud MCP

Install smbCloud MCP in Claude Code

Install smbCloud MCP in Cursor

Install smbCloud MCP in VS Code

Install smbCloud MCP in VS Code CLI

Install smbCloud MCP in Claude Desktop

Install smbCloud MCP in Codex

Install smbCloud MCP in Codex config.toml

Install smbCloud MCP in Gemini CLI

Install smbCloud MCP in Gemini settings.json

Configuration

Automated checks

README

Install

Use it your way

Docs

Contributing

License

Copyright

smbCloud MCP questions

smbCloud MCP server

What is smbCloud MCP?

About smbCloud MCP server

What you can do with it

How to install smbCloud MCP

Install smbCloud MCP in Claude Code

Install smbCloud MCP in Cursor

Install smbCloud MCP in VS Code

Install smbCloud MCP in VS Code CLI

Install smbCloud MCP in Claude Desktop

Install smbCloud MCP in Codex

Install smbCloud MCP in Codex config.toml

Install smbCloud MCP in Gemini CLI

Install smbCloud MCP in Gemini settings.json

Configuration

Automated checks

README

Install

Use it your way

Docs

Contributing

License

Copyright

smbCloud MCP questions