moMottainai CLI
Take Mottainai to the command line
The mo CLI brings containers (storages and boards), items, shopping lists, and tokens right into your terminal. Free and open source.
$ mo --help
CLI for Mottainai home storage tracking.
Usage:
mo [command]
Available Commands:
auth Manage authentication
board Manage boards (alias for container --type board)
container Manage containers (storages and boards)
item Manage items
shopping Manage shopping list
storage Manage storages (alias for container --type storage)
token Manage API tokens
version Print the CLI version
Flags:
-h, --help help for mo
Use "mo [command] --help" for more information.
Goodbye, app switching. Hello, terminal.
Everything you can do in the Mottainai app, now scriptable, pipeable, and automatable from the command line.
Containers & items
List, create, and delete containers. The --yes flag still protects destructive actions, and --type storage filters container commands to storage containers.
$ mo container list --type storage
ID TYPE NAME ROLE CREATED
a1b2c3d4 storage Kitchen Pantry owner Jan 15
e5f6g7h8 storage Wine Cellar admin Mar 22
i9j0k1l2 storage Garage member Jun 10
$ mo item list a1b2c3d4
ID NAME QTY UNIT CATEGORY LOCATION EXPIRES
x1 Olive Oil 2 btl Pantry Shelf 2 -
x2 Pasta 5 pack Dry Goods Top Bin -
x3 Coffee Beans 1 bag Beverages Pantry 2026-03-12
Boards
List all Kanban boards and their cards. Check progress across projects without opening a browser.
$ mo board list
ID NAME COLUMNS CARDS
b1c2d3e4 Home Projects 4 12
f5g6h7i8 Weekly Tasks 3 8
j9k0l1m2 Shopping Ideas 2 5
$ mo token list
NAME EXPIRES LAST USED
CI Pipeline 2026-03-01 2 hrs ago
Home Server Never Yesterday
Script & automate
Add --json to any command and pipe the output into jq, scripts, or your own tools.
$ mo container list --type storage --json
[
{
"id": "e5f6g7h8",
"type": "storage",
"name": "Wine Cellar",
"myRole": "admin",
"createdAt": "2026-02-19T09:41:27Z"
}
]
$ mo container delete e5f6g7h8 --yes
Deleted container e5f6g7h8
Built for humans and agents alike
One-command login
mo auth login opens your browser, handles OAuth, and saves your token. No copy-pasting credentials.
JSON everywhere
Every command supports --json. Pipe into jq, feed into scripts, or build your own integrations.
Agent-native
mo is designed for AI agents. Pair it with the Mottainai MCP server and let Claude manage your containers for you.
Safe by default
Destructive commands ask for confirmation. Skip the prompt in scripts with --yes. Nothing is irreversible by surprise.
Install mo
One command installs the binary for your platform. Then authenticate once via browser OAuth — your token is stored securely and used for every subsequent command.
Want to check first? View install.sh — it's a short, readable shell script.
Using Claude Code? Download the Claude skill — lets Claude run mo on your behalf.
Create account$ curl -sSfL mottainai.app/cli/install.sh | sh
Detecting platform: darwin/arm64
Downloading mo v0.1.0...
✓ Installed mo to /usr/local/bin/mo
$ mo auth login
Opening browser for authentication...
✓ Logged in as Alice (alice@example.com)
$ mo container list --type storage
ID TYPE NAME ROLE CREATED
a1b2c3d4 storage Kitchen Pantry owner Jan 15
e5f6g7h8 storage Wine Cellar admin Mar 22