Monica CRM

Drive a Monica CRM v4 instance from the CLI at scripts/monica — a single stdlib-only Python 3 script. Every command prints compact JSON on stdout; errors go to stderr with a Monica error code and a non-zero exit.

Setup

1. Get a Personal Access Token: in Monica, go to Settings → API → Create Personal Access Token.
2. Copy .env.example to ~/.config/monica-api/.env (chmod 600) and fill in MONICA_API_URL (e.g. https://your-instance.example.com/api) and MONICA_API_TOKEN. Env vars MONICA_API_URL/MONICA_API_TOKEN override the file if set. Self-signed instances can point MONICA_API_CA_BUNDLE at a CA file — TLS verification is always on.
3. Verify: scripts/monica whoami — should print your user + me_contact object.
4. Full validation: scripts/selftest.sh — runs a live create/read/update/delete cycle against the configured instance (creates and fully removes "ZZZ Selftest" contacts and a scratch tag; this touches the live instance, not a sandbox). Expect PASS=15 FAIL=0 and tag cleanup: ok.