Skip to content

create_item should support a description parameter (markdown) #314

@david206

Description

@david206

Problem

There is no way to set an item's description when creating an item. The only path is a two-step flow:

  1. create_item — creates the item
  2. all_monday_api with set_item_description_content — sets the description via raw GraphQL

The second step requires knowing that set_item_description_content exists at all, which means dumping and grepping the full GraphQL schema (51KB). In practice, LLM agents fall back to create_update instead — which creates an update (on the second task tab), not a description (on the first task tab).

Root cause

set_item_description_content was added to the Monday API on January 26, 2026 (v2026-04) and is not yet surfaced as a dedicated MCP tool.

Proposed fix

Add an optional description (markdown string) parameter to create_item. Internally, after creating the item, the tool calls set_item_description_content with the provided markdown.

This collapses a two-call, schema-diving workflow into a single obvious operation.

Alternatives considered

  • A standalone set_item_description tool — better than the current situation where agents use create_update, but doesn't solve the creation case
  • Documenting the mutation in all_monday_api's description — reduces the discoverability gap but doesn't fix the DX

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions