KosmoKrator

productivity

Monday.com CLI for AI Agents

Use the Monday.com CLI from KosmoKrator to call Monday.com tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 6 read 1 write API token auth

Monday.com CLI Setup

Monday.com can be configured headlessly with `kosmokrator integrations:configure monday`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure monday --set api_token="$MONDAY_API_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor monday --json
kosmokrator integrations:status --json

Credentials

Authentication type: API token api_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_token MONDAY_API_TOKEN Secret secret yes API Token

Call Monday.com Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call monday.monday_list_boards '{
  "limit": 1,
  "workspace_id": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:monday monday_list_boards '{
  "limit": 1,
  "workspace_id": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs monday --json
kosmo integrations:docs monday.monday_list_boards --json
kosmo integrations:schema monday.monday_list_boards --json
kosmo integrations:search "Monday.com" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Monday.com.

monday.monday_list_boards

Read read

List Monday.com boards the authenticated user has access to. Optionally filter by workspace. Returns board name, kind, workspace, owner, and item count. Use monday_list_workspaces to discover workspace IDs.

Parameters
limit, workspace_id

Generic CLI call

kosmo integrations:call monday.monday_list_boards '{"limit":1,"workspace_id":1}' --json

Provider shortcut

kosmo integrations:monday monday_list_boards '{"limit":1,"workspace_id":1}' --json

monday.monday_get_board

Read read

Get a single Monday.com board by ID. Returns full board details including all columns (with types) and groups. Use monday_list_boards to discover board IDs.

Parameters
board_id

Generic CLI call

kosmo integrations:call monday.monday_get_board '{"board_id":1}' --json

Provider shortcut

kosmo integrations:monday monday_get_board '{"board_id":1}' --json

monday.monday_list_items

Read read

List items on a Monday.com board with pagination. Returns item name, state, group, creator, and timestamps. Use monday_list_boards or monday_get_board to discover board IDs.

Parameters
board_id, limit, page

Generic CLI call

kosmo integrations:call monday.monday_list_items '{"board_id":1,"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:monday monday_list_items '{"board_id":1,"limit":1,"page":1}' --json

monday.monday_get_item

Read read

Get a single Monday.com item by ID. Returns full item details including all column values, board info, group, and creator.

Parameters
item_id

Generic CLI call

kosmo integrations:call monday.monday_get_item '{"item_id":1}' --json

Provider shortcut

kosmo integrations:monday monday_get_item '{"item_id":1}' --json

monday.monday_create_item

Write write

Create a new item on a Monday.com board. Requires a board ID and item name. Optionally set a group and initial column values. Use monday_get_board to discover group IDs and column IDs.

Parameters
board_id, item_name, group_id, column_values

Generic CLI call

kosmo integrations:call monday.monday_create_item '{"board_id":1,"item_name":"example_item_name","group_id":"example_group_id","column_values":"example_column_values"}' --json

Provider shortcut

kosmo integrations:monday monday_create_item '{"board_id":1,"item_name":"example_item_name","group_id":"example_group_id","column_values":"example_column_values"}' --json

monday.monday_list_workspaces

Read read

List Monday.com workspaces the authenticated user has access to. Returns workspace name, kind, description, and subscriber counts. Use workspace IDs to filter boards in monday_list_boards.

Parameters
limit

Generic CLI call

kosmo integrations:call monday.monday_list_workspaces '{"limit":1}' --json

Provider shortcut

kosmo integrations:monday monday_list_workspaces '{"limit":1}' --json

monday.monday_get_current_user

Read read

Get the currently authenticated Monday.com user's profile, including ID, name, email, avatar URL, title, location, and timezone.

Parameters
none

Generic CLI call

kosmo integrations:call monday.monday_get_current_user '{}' --json

Provider shortcut

kosmo integrations:monday monday_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

monday.monday_list_boards

List Monday.com boards the authenticated user has access to. Optionally filter by workspace. Returns board name, kind, workspace, owner, and item count. Use monday_list_workspaces to discover workspace IDs.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_list_boards --json
ParameterTypeRequiredDescription
limit integer no Max boards to return. Default: 25.
workspace_id integer no Filter boards by workspace ID.

monday.monday_get_board

Get a single Monday.com board by ID. Returns full board details including all columns (with types) and groups. Use monday_list_boards to discover board IDs.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_get_board --json
ParameterTypeRequiredDescription
board_id integer yes Board ID to retrieve.

monday.monday_list_items

List items on a Monday.com board with pagination. Returns item name, state, group, creator, and timestamps. Use monday_list_boards or monday_get_board to discover board IDs.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_list_items --json
ParameterTypeRequiredDescription
board_id integer yes Board ID to list items for.
limit integer no Results per page. Default: 25.
page integer no Page number (1-based). Default: 1.

monday.monday_get_item

Get a single Monday.com item by ID. Returns full item details including all column values, board info, group, and creator.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_get_item --json
ParameterTypeRequiredDescription
item_id integer yes Item ID to retrieve.

monday.monday_create_item

Create a new item on a Monday.com board. Requires a board ID and item name. Optionally set a group and initial column values. Use monday_get_board to discover group IDs and column IDs.

Operation
Write write
Schema command
kosmo integrations:schema monday.monday_create_item --json
ParameterTypeRequiredDescription
board_id integer yes Board ID to create the item on.
item_name string yes Name of the new item.
group_id string no Group ID to place the item in.
column_values object no Column values to set, keyed by column ID. Values depend on column type.

monday.monday_list_workspaces

List Monday.com workspaces the authenticated user has access to. Returns workspace name, kind, description, and subscriber counts. Use workspace IDs to filter boards in monday_list_boards.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_list_workspaces --json
ParameterTypeRequiredDescription
limit integer no Max workspaces to return. Default: 50.

monday.monday_get_current_user

Get the currently authenticated Monday.com user's profile, including ID, name, email, avatar URL, title, location, and timezone.

Operation
Read read
Schema command
kosmo integrations:schema monday.monday_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.