zspace-cli — Claude Code MCP server: features and setup
Let an AI agent work with files and storage details on a ZSpace NAS. The ZSpace desktop client must be running on macOS.
claude mcp add zspace-cli -- uvx zspace-cliWhat zspace-cli does
The MCP tools let an agent browse NAS folders, search for files, transfer data, and rename, move, or copy items. It can also inspect pool usage, disk status, and recycle-bin contents. The zs command-line interface exposes these operations too.
Access goes through the logged-in ZSpace desktop client on macOS. Keep that client running; without it, the server cannot reach the NAS. To register the server with Claude Code, run claude mcp add zspace-cli -- uvx zspace-cli.
What it helps with
- locate a NAS file by name
- upload a local file to ZSpace
- download a file from the NAS
- inspect pool usage and disk health
- restore an item from the recycle bin
Example prompts for the agent
- Find the NAS file named “contract” and show its path.
- Upload
./report.pdfto/sata11/my/data. - Check storage usage for each pool.
How to install zspace-cli
Platform CLI
claude mcp add zspace-cli -- uvx zspace-cliuvx runs the command named after the package; if the README names another one, use uvx --from zspace-cli <command>
Platform CLI
codex mcp add zspace-cli -- uvx zspace-cliuvx runs the command named after the package; if the README names another one, use uvx --from zspace-cli <command>
Config file
{
"mcpServers": {
"zspace-cli": {
"command": "uvx",
"args": [
"zspace-cli"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from zspace-cli <command>
Config file
{
"servers": {
"zspace-cli": {
"type": "stdio",
"command": "uvx",
"args": [
"zspace-cli"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from zspace-cli <command>
Platform CLI
gemini mcp add zspace-cli uvx zspace-cliuvx runs the command named after the package; if the README names another one, use uvx --from zspace-cli <command>
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 zspace-cli
How do I install zspace-cli in Claude Code?
Run claude mcp add zspace-cli -- uvx zspace-cli. The ZSpace desktop client must be open and logged in on macOS.
What does zspace-cli do?
It gives an AI agent MCP access to ZSpace NAS file operations and storage information. The same core tasks are also available through the zs CLI.
What does zspace-cli need to connect to the NAS?
A logged-in ZSpace desktop client must be running on macOS. The server uses that client to access the NAS.
