@mailrith/cli

Mailrith CLI

Use Mailrith from a terminal or non-interactive agent runtime without building raw HTTP requests.

npx @mailrith/cli auth login
npx @mailrith/cli capabilities --json
npx @mailrith/cli operations search "schedule the newsletter" --json
npx @mailrith/cli operations describe scheduleBroadcast --json
npx @mailrith/cli call subscribers list --query limit=10 --json

auth login uses the Full Email Marketing Access profile by default, so the CLI can use every public email-marketing operation in the selected workspace after the user approves access. This includes secure email delivery setup, Subscriber imports and exports, and Outbound Webhooks. It does not grant billing, team, account-security, credential-reading, or internal administration access.

Use a view-only connection when the workflow only needs reporting:

npx @mailrith/cli auth login --profile reporting

Repeat --scope to request an exact custom permission set. Explicit scopes take precedence over --profile.

Every Work Profile shown by Mailrith OAuth is accepted by --profile; run npx @mailrith/cli --help to list their stable keys.

The CLI is generated-SDK based. It keeps saved credentials in a mode-0600 configuration file, never prints API keys, refresh tokens, or access tokens, and bounds automatic pagination.

Operation search and schema inspection do not require a credential or a network request. Search uses the same bounded, in-memory intent catalog as the MCP server. operations describe returns only the selected operation's exact input schema and loads the larger contract only for that explicit command; add --include-output-schema only when the response contract is also needed.

See Mailrith Developer Docs for OAuth, safety, workflow, and configuration guidance.