Waymaker teams

Overview

Manage teams within your organization. Teams group users for collaboration, permissions, and workspace access.

Usage

waymaker teams <subcommand> [options]

Subcommands

Subcommand	Description
list	List teams in the organization
get	Get team details
create	Create a new team
update	Update team settings
members	Manage team membership

List Teams

waymaker teams list

Output:

Teams (6)

id           name              members   workspaces   created
-------------------------------------------------------------
team_abc123  Engineering       12        4            Jan 2026
team_def456  Product           8         3            Jan 2026
team_ghi789  Marketing         6         2            Jan 2026
team_jkl012  Sales             15        5            Jan 2026

JSON Output

waymaker teams list --json

[
  {
    "id": "team_abc123",
    "name": "Engineering",
    "description": "Engineering team",
    "member_count": 12,
    "workspace_count": 4,
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Get Team Details

waymaker teams get <team-id>

Output:

Engineering

ID: team_abc123
Members: 12
Workspaces: 4
Created: January 1, 2026

Description:
Core engineering team responsible for platform development

Members:
  - John Smith (Lead)
  - Jane Doe
  - Bob Wilson
  ...

Workspaces:
  - Platform Development
  - Infrastructure
  - API Design
  - Testing

JSON Output

waymaker teams get team_abc123 --json

Create Team

waymaker teams create \
  --name "New Team" \
  --description "Team description"

Output:

✓ Team created
ID: team_new123
Name: New Team

Create with Initial Members

waymaker teams create \
  --name "Project Alpha" \
  --description "Alpha project team" \
  --members user_abc123,user_def456

Update Team

waymaker teams update <team-id> \
  --name "Updated Name" \
  --description "Updated description"

Manage Team Members

List Members

waymaker teams members <team-id> list

Output:

Team Members: Engineering (12)

id           name              role        joined
-------------------------------------------------
user_abc123  John Smith        lead        Jan 2026
user_def456  Jane Doe          member      Jan 2026
user_ghi789  Bob Wilson        member      Jan 2026

Add Member

waymaker teams members <team-id> add --user <user-id>

Remove Member

waymaker teams members <team-id> remove --user <user-id>

Set Member Role

waymaker teams members <team-id> role --user <user-id> --role lead

Options Reference

list

Option	Type	Description
--json	flag	Output as JSON

get

Option	Type	Description
--json	flag	Output as JSON

create

Option	Type	Description
--name	string	Required. Team name
--description	string	Team description
--members	string	Comma-separated user IDs

update

Option	Type	Description
--name	string	New team name
--description	string	New description

members

Option	Type	Description
--user	string	User ID for add/remove/role
--role	enum	Member role (lead, member)
--json	flag	Output as JSON

AI Agent Workflow

# List all teams
TEAMS=$(waymaker teams list --json)

# Get team by name
TEAM_ID=$(echo $TEAMS | jq -r '.[] | select(.name == "Engineering") | .id')

# Get team details
waymaker teams get $TEAM_ID --json

# Add user to team
waymaker teams members $TEAM_ID add --user $USER_ID

# Create team for new project
waymaker teams create \
  --name "Project $(date +%Y-%m)" \
  --description "Monthly project team"

MCP Tools (Claude Desktop)

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

commander_team_list

List all teams in an organization.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID

Example prompts:

"List all teams in the organization"

"Show me our teams"

commander_team_create

Create a new team.

Parameters:

Parameter	Type	Required	Description
organization_id	string	Yes	Organization UUID or Clerk ID
name	string	Yes	Team name
description	string	No	Team description
lead_user_id	string	No	User ID of team lead

Example prompts:

"Create an Engineering team with Sarah as lead"

"Create a Marketing team"

"Set up a new QA team with a description 'Quality Assurance and Testing'"

commander_team_add_member

Add users to a team.

Parameters:

Parameter	Type	Required	Description
team_id	string	Yes	Team UUID
user_ids	array	Yes	Array of user IDs to add
role	string	No	Role: member or lead

Example prompts:

"Add John to the Engineering team"

"Add the new hires to the Marketing team"

"Add Sarah as a lead of the QA team"

commander_team_remove_member

Remove users from a team.

Parameters:

Parameter	Type	Required	Description
team_id	string	Yes	Team UUID
user_ids	array	Yes	Array of user IDs to remove

Example prompts:

"Remove Bob from the Engineering team"

"Remove the contractors from the Product team"

Related Commands

• users - Manage users
• roles - Manage roles
• workspaces - Manage workspaces