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.

Monday.com CLI Setup

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

Install, configure, and verify
# 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 reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

KeyEnv varTypeRequiredLabel
api_token MONDAY_API_TOKEN Secret secret yes API Token

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

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

Discovery

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

Discovery commands
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

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

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.

Read read
Parameters
limit, workspace_id
Generic call
kosmo integrations:call monday.monday_list_boards '{"limit":1,"workspace_id":1}' --json
Shortcut
kosmo integrations:monday monday_list_boards '{"limit":1,"workspace_id":1}' --json

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.

Read read
Parameters
board_id
Generic call
kosmo integrations:call monday.monday_get_board '{"board_id":1}' --json
Shortcut
kosmo integrations:monday monday_get_board '{"board_id":1}' --json

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.

Read read
Parameters
board_id, limit, page
Generic call
kosmo integrations:call monday.monday_list_items '{"board_id":1,"limit":1,"page":1}' --json
Shortcut
kosmo integrations:monday monday_list_items '{"board_id":1,"limit":1,"page":1}' --json

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.

Read read
Parameters
item_id
Generic call
kosmo integrations:call monday.monday_get_item '{"item_id":1}' --json
Shortcut
kosmo integrations:monday monday_get_item '{"item_id":1}' --json

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.

Write write
Parameters
board_id, item_name, group_id, column_values
Generic 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
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

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.

Read read
Parameters
limit
Generic call
kosmo integrations:call monday.monday_list_workspaces '{"limit":1}' --json
Shortcut
kosmo integrations:monday monday_list_workspaces '{"limit":1}' --json

monday.monday_get_current_user

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

Read read
Parameters
none
Generic call
kosmo integrations:call monday.monday_get_current_user '{}' --json
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 2 parameters
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 1 parameters
Schema command
kosmo integrations:schema monday.monday_get_board --json
ParameterTypeRequiredDescription
board_id integer yes Board ID to retrieve.
monday.monday_list_items 3 parameters
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 1 parameters
Schema command
kosmo integrations:schema monday.monday_get_item --json
ParameterTypeRequiredDescription
item_id integer yes Item ID to retrieve.
monday.monday_create_item 4 parameters
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 1 parameters
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 0 parameters
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.