Skip to content

fix(read-docs): add item_column type to read docs attached to board items#344

Open
Noa-Reuven wants to merge 3 commits into
masterfrom
noa/fix/docs-column-read
Open

fix(read-docs): add item_column type to read docs attached to board items#344
Noa-Reuven wants to merge 3 commits into
masterfrom
noa/fix/docs-column-read

Conversation

@Noa-Reuven
Copy link
Copy Markdown
Collaborator

Summary

The read_docs MCP tool returns "No documents found" for docs attached to board items via a doc column. This is because the platform docs() query uses a high_level_objects scope that silently excludes all column-attached docs.

This PR adds a new "item_column" query type to read_docs that passes item_id + column_id directly to the API, bypassing the scope.

  • Adds item_id and column_id fields to the tool schema
  • Adds "item_column" as a valid type option (alongside "ids", "object_ids", "workspace_ids")
  • Updates schema.graphql and readDocs query with the new arguments
  • No ids-fallback retry for item_column — if not found, that is the final answer
  • Updates tool description to document the new type

Usage:

{ "type": "item_column", "item_id": "8386012534", "column_id": "monday_doc_mkmt9fgg" }

Test plan

  • 5 new Jest tests: correct variable wiring, returns content, error on missing item_id, error on missing column_id, no fallback retry
  • Full suite: 919/919 tests passing

Depends on: DaPulse/dapulse#109627 must be deployed first.

🤖 Generated with Claude Code

Noa-Reuven and others added 3 commits May 14, 2026 10:56
…ry and schema

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
…columns

Adds item_id + column_id fields to the tool schema and a new 'item_column'
query type. When used, the tool passes item_id and column_id directly to the
docs() query, bypassing the high_level_objects scope that silently excludes
all column-attached docs.

No ids-fallback retry is triggered for item_column — if the column doc is not
found, that is the final answer.

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant