Waymaker users

Overview

Manage organization users. List users, view profiles, and manage user access within your organization.

Usage

waymaker users <subcommand> [options]

Subcommands

Subcommand	Description
list	List users in the organization
get	Get user details
invite	Invite a new user
remove	Remove a user from organization

List Users

waymaker users list

Output:

Organization Users (25)

id           name              email                    role        status
--------------------------------------------------------------------------
user_abc123  John Smith        john@company.com         admin       active
user_def456  Jane Doe          jane@company.com         member      active
user_ghi789  Bob Wilson        bob@company.com          member      invited

Filter by Role

waymaker users list --role admin

Filter by Status

waymaker users list --status active

JSON Output

waymaker users list --json

[
  {
    "id": "user_abc123",
    "name": "John Smith",
    "email": "john@company.com",
    "role": "admin",
    "status": "active",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Get User Details

waymaker users get <user-id>

Output:

John Smith

ID: user_abc123
Email: john@company.com
Role: admin
Status: active
Joined: January 1, 2026

Teams: (3)
  - Engineering
  - Product
  - Leadership

Workspaces: (5)
  - Q1 Planning
  - Product Development
  - Marketing

JSON Output

waymaker users get user_abc123 --json

Invite User

waymaker users invite \
  --email "newuser@company.com" \
  --role member

Output:

✓ Invitation sent
Email: newuser@company.com
Role: member
Expires: January 28, 2026

Invite to Specific Teams

waymaker users invite \
  --email "newuser@company.com" \
  --role member \
  --teams team_abc123,team_def456

Remove User

waymaker users remove <user-id>

Output:

✓ User removed
User: John Smith (john@company.com)

Force Remove (Skip Confirmation)

waymaker users remove user_abc123 --force

Options Reference

list

Option	Type	Description
--role	enum	Filter by role (admin, member)
--status	enum	Filter by status (active, invited, suspended)
--json	flag	Output as JSON

get

Option	Type	Description
--json	flag	Output as JSON

invite

Option	Type	Description
--email	string	Required. User email address
--role	enum	User role (admin, member). Default: member
--teams	string	Comma-separated team IDs

remove

Option	Type	Description
--force	flag	Skip confirmation prompt

AI Agent Workflow

# List all active users
USERS=$(waymaker users list --status active --json)

# Get user count
echo $USERS | jq 'length'

# Find admins
ADMINS=$(waymaker users list --role admin --json)

# Invite new team member
waymaker users invite \
  --email "$NEW_USER_EMAIL" \
  --role member \
  --teams "$TEAM_IDS"

MCP Tools (Claude Desktop)

When using the Waymaker MCP server with Claude Desktop or other AI assistants, these tools are available:

commander_user_list

List all users in an organization.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
limit	number	No	Maximum users to return

Example prompts:

"List all users in the organization"

"Show me team members"

commander_user_get

Get a user's details.

Parameters:

Parameter	Type	Required	Description
user_id	string	Yes	User ID (Clerk user ID)
organization_id	string	No	Organization context

Example prompts:

"Get user details for user_abc123"

"Show me information about John's account"

commander_user_invite

Invite a new user to the organization.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
email	string	Yes	Email address to invite
role	string	No	member or admin (default: member)
team_ids	array	No	Team IDs to add user to
message	string	No	Custom invitation message

Example prompts:

"Invite developer@example.com to the organization"

"Invite sarah@company.com as an admin"

"Invite the new hire and add them to the Engineering and QA teams"

Related Commands

• teams - Manage teams
• roles - Manage roles and permissions
• orgs - Organization settings