nori-luma-cli

CLI for the Luma event platform API. Covers all 61 API endpoints across 10 command groups. Designed for agentic use — all output is JSON, all parameters are flags, no interactivity.

Install

From npm:

npm install -g nori-luma-cli

This puts the nori-luma command on your PATH. Note the command is nori-luma, not the package name nori-luma-cli.

From source (for contributors):

git clone https://github.com/tilework-tech/nori-luma-cli.git
cd nori-luma-cli
npm install
npm run build
npm link   # makes `nori-luma` available globally

Then set your API key:

export LUMA_API_KEY=your-key-here

Get your API key from: Luma App → Calendars Home → Settings → Developer → API Keys.

Usage

Help and version output work before LUMA_API_KEY is set. API commands require the key.

nori-luma <command> [subcommand] [options]

Contributors working from a clone can run without building via npm run dev -- <command> [options].

Commands

| Command | Subcommands | Description | |---------|------------|-------------| | events | list, get, create, update, cancel, list-coupons, create-coupon, update-coupon | Manage events and event-scoped coupons | | guests | list, get, add, update-status, send-invites | Manage event guests and invitations | | hosts | add, update, remove | Manage event hosts | | ticket-types | list, get, create, update, delete | Manage event ticket types | | calendar | get, lookup-event, add-event, approve-event, reject-event, list-admins, list-coupons, create-coupon, update-coupon, list-event-tags, create-event-tag, update-event-tag, delete-event-tag, apply-event-tag, unapply-event-tag | Calendar settings, admins, coupons, event tags | | contacts | list, import, list-contact-tags, create-contact-tag, apply-contact-tag, unapply-contact-tag, update-contact-tag, delete-contact-tag | Manage contacts and contact tags | | membership | list-tiers, add-member, update-member-status | Manage membership tiers and members | | organization | list-admins, list-calendars, list-events, transfer-event, create-calendar | Organization-level management (requires org-scoped API key) | | webhook | list, get, create, update, delete | Manage webhook endpoints | | utility | get-self, entity-lookup, image-upload | Account info, slug lookup, image uploads |

Use --help on any command or subcommand for detailed usage:

nori-luma events --help
nori-luma events create --help

Examples

# List upcoming events
nori-luma events list --after 2024-01-01T00:00:00Z

# Create an event
nori-luma events create \
  --name "Meetup" \
  --start-at "2024-07-01T18:00:00Z" \
  --timezone "America/New_York" \
  --visibility public

# Get guest list
nori-luma guests list --event-id evt-xxx

# Look up a lu.ma slug
nori-luma utility entity-lookup --slug my-community

Testing

npm test

287 tests across 13 test files covering all command groups, parse utilities, startup behavior, and program-level behavior.

License

See LICENSE and LICENSE-ADDENDUM.txt.