Monday

Query and create monday.com work items via the monday.com GraphQL API (https://api.monday.com/v2). Standard-library Python only — no external dependencies.

What it does

monday.com is a Work OS organized into boards (tables) that hold items (rows), each with column values. This tool reads boards/items and writes new items or column updates through a single GraphQL endpoint.

The endpoint always returns HTTP 200; GraphQL-level problems come back in an errors array. The tool detects that and fails the step with the error message so automations don't silently succeed on a bad request.

Operations

Inputs

• apiKey (required) — your monday.com personal API token (see below).
• operation (required) — one of the operations above.
• boardId — numeric board id. Discover it with list-boards.
• itemId — numeric item id (for change-column-values).
• itemName — name of the item to create (for create-item).
• columnValues — a JSON string matching monday's column-values format, e.g. {"status":{"label":"Done"},"text":"hello"}. Optional for create-item, required for change-column-values.
• limit — max boards/items to return (1–100, default 25).

Outputs

• result — the GraphQL data object, serialized as a JSON string.
• status — the HTTP status code as a string (normally 200).

How to get the apiKey

1. In monday.com, click your profile picture (top right).
2. Choose Developers to open the Developer Center.
3. Open API token and click Show, then copy the token.

(Admins can also retrieve it under Administration → Connections → Personal API token.) The token mirrors your monday.com permissions and is sent verbatim in the Authorization header — no Bearer prefix.

Examples

1. List your boards to find a board id

monday apiKey=<token> operation=list-boards limit=10

result contains an array like [{"id":"1234567890","name":"Tasks","state":"active",...}].

2. Create an item on a board with a status column set

monday apiKey=<token> operation=create-item boardId=1234567890 \
       itemName="Ship release notes" \
       columnValues={"status":{"label":"Working on it"}}

result contains the new item: {"create_item":{"id":"...","name":"Ship release notes"}}.

Notes

• Pins the schema to API-Version: 2024-10.
• Response bodies are capped at ~5 MB.
• Grounded in the official docs: https://developer.monday.com/api-reference/docs

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.