SmartMoving MCP + CLI

Launch status: public 0.1.0 prep. This repo documents an unofficial MCP server and CLI with 62 operations, read-only by default safety gates, and an agent-ready schema for terminal and MCP clients.

What this project is

SmartMoving MCP + CLI exposes the SmartMoving External API v1 to authorized users through two local interfaces:

• an MCP stdio server for Claude Desktop, Hermes Agent, Cursor, Codex-style clients, and other MCP-compatible agents;
• a smartmoving CLI for diagnostics, schema discovery, smoke tests, command docs, and scripted workflows.

Unofficial project. This project is not affiliated with, endorsed by, sponsored by, or certified by SmartMoving, LLC. “SmartMoving” is used only to identify the external API this project interoperates with.

Why agents use it

62 operations

Customers, leads, opportunities, jobs, inventory, follow-ups, communication, reference data, and API health checks.

Safe by default

Reads are available with an API key. Writes need SMARTMOVING_ALLOW_WRITES=true; destructive tools also need SMARTMOVING_ALLOW_DESTRUCTIVE=true.

Agent-ready schema

smartmoving schema --json exposes names, groups, safety levels, CLI metadata, related MCP tools, output modes, and exit codes.

CLI + MCP

Use MCP for native tool discovery and CLI for explicit terminal workflows, smoke tests, and machine-readable JSON.

One-line install CTA

After maintainers publish the npm package, run:

npm install -g smartmoving-mcp-server

Then configure your API key privately and start with read-only commands:

smartmoving init --yes --profile default --api-key-env SMARTMOVING_API_KEY
smartmoving doctor --json
smartmoving schema --json

For one-off MCP launches after publish:

npx -y smartmoving-mcp-server

For local development before publish, clone the repo and build from mcp-server/.

Next pages

• Quickstart — shortest safe path from clone or npm to a working CLI/MCP setup.
• Install — source, future npm, and environment setup.
• MCP setup — client snippets for Claude, Hermes, and generic MCP.
• CLI docs — command patterns and JSON output contract.
• Safety model — read/write/destructive gates and approval checklist.