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 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.
| Key | Env var | Type | Required | Label |
|---|---|---|---|---|
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.
kosmo integrations:call monday.monday_list_boards '{"limit":1,"workspace_id":1}' --json 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.
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 - Parameters
- limit, workspace_id
kosmo integrations:call monday.monday_list_boards '{"limit":1,"workspace_id":1}' --json 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 - Parameters
- board_id
kosmo integrations:call monday.monday_get_board '{"board_id":1}' --json 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 - Parameters
- board_id, limit, page
kosmo integrations:call monday.monday_list_items '{"board_id":1,"limit":1,"page":1}' --json 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 - Parameters
- item_id
kosmo integrations:call monday.monday_get_item '{"item_id":1}' --json 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 - Parameters
- board_id, item_name, group_id, column_values
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 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 - Parameters
- limit
kosmo integrations:call monday.monday_list_workspaces '{"limit":1}' --json 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 - Parameters
- none
kosmo integrations:call monday.monday_get_current_user '{}' --json 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
kosmo integrations:schema monday.monday_list_boards --json | Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Max boards to return. Default: 25. |
workspace_id | integer | no | Filter boards by workspace ID. |
monday.monday_get_board 1 parameters
kosmo integrations:schema monday.monday_get_board --json | Parameter | Type | Required | Description |
|---|---|---|---|
board_id | integer | yes | Board ID to retrieve. |
monday.monday_list_items 3 parameters
kosmo integrations:schema monday.monday_list_items --json | Parameter | Type | Required | Description |
|---|---|---|---|
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
kosmo integrations:schema monday.monday_get_item --json | Parameter | Type | Required | Description |
|---|---|---|---|
item_id | integer | yes | Item ID to retrieve. |
monday.monday_create_item 4 parameters
kosmo integrations:schema monday.monday_create_item --json | Parameter | Type | Required | Description |
|---|---|---|---|
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
kosmo integrations:schema monday.monday_list_workspaces --json | Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Max workspaces to return. Default: 50. |
monday.monday_get_current_user 0 parameters
kosmo integrations:schema monday.monday_get_current_user --json | Parameter | Type | Required | Description |
|---|---|---|---|
| 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.