Skip to content

Add date range filtering to get_updates tool#240

Merged
roieu merged 6 commits into
masterfrom
feat/roie/get-updates-date-range-filtering
Mar 18, 2026
Merged

Add date range filtering to get_updates tool#240
roieu merged 6 commits into
masterfrom
feat/roie/get-updates-date-range-filtering

Conversation

@roieu
Copy link
Copy Markdown
Contributor

@roieu roieu commented Mar 18, 2026

Summary

  • Add fromDate and toDate optional parameters to the get_updates tool for board-level queries, enabling date range filtering on board updates (ISO8601 format, both required together)
  • Add includeItemUpdates parameter (defaults to false, preserving current behavior) instead of hardcoding board_updates_only: true in the GraphQL query. Agents can set includeItemUpdates: true to also retrieve item-level updates on a board. Follows the same naming convention as includeReplies / includeAssets.
  • Add input validation: error when only one date is provided, or when date params are used with objectType: Item (not supported by the API)

Context

Sidekick currently cannot answer questions about updates within a specific date range. The monday.com API supports from_date/to_date on Board.updates but the MCP tool didn't expose these parameters. This change makes that capability available to all agents.

Discussion thread: https://monday.slack.com/archives/C09MKR01006/p1772800703095789

Changes

File Change
get-updates.graphql.ts Add $fromDate, $toDate, $boardUpdatesOnly variables to GetBoardUpdates query
get-updates-tool.ts Add fromDate, toDate, includeItemUpdates schema fields, input validation, update executor and description
get-updates-tool.test.ts 7 new test cases + updated existing board test expectations
generated/graphql/* Regenerated via codegen
package.json Minor version bump to 3.1.0

Test plan

  • Board updates with fromDate/toDate — verify variables are passed to the query
  • Validation: error when only fromDate or only toDate is provided
  • Validation: error when date params are used with objectType: Item
  • Board updates with includeItemUpdates: true — verify boardUpdatesOnly: false is passed to GraphQL
  • Default board query passes boardUpdatesOnly: true (backward compatible)
  • Date variables not included when dates are not provided
  • All 19 tests pass

Made with Cursor

roieu added 4 commits March 18, 2026 12:39
Enable board-level update queries to filter by date range using fromDate/toDate
(ISO8601 format). Both parameters must be provided together and are only supported
for Board objectType. Also expose boardUpdatesOnly as a parameter (defaults to true,
preserving current behavior) so agents can explicitly opt in to retrieving item-level
updates alongside board-level ones.

Made-with: Cursor
Replace the negative-logic boardUpdatesOnly (default true) with the positive-logic
includeItemUpdates (default false). This aligns with the existing includeReplies
and includeAssets naming convention and avoids confusing double-negation.

Made-with: Cursor
roieu added 2 commits March 18, 2026 16:21
The Board.updates GraphQL field expects ISO8601DateTime (e.g.
"2025-01-01T00:00:00Z"), but agents naturally pass date-only strings
("2025-01-01"). Add normalizeToISO8601DateTime() to append T00:00:00Z
when a YYYY-MM-DD string is detected, while passing full datetime
strings through unchanged.

Made-with: Cursor
@roieu roieu merged commit 7b61d23 into master Mar 18, 2026
1 check passed
@github-actions
Copy link
Copy Markdown

🏷️ Version Bump Preview

Type: minor
Current: v0.0.139
Next: v0.1.0

✅ This is just a preview! The actual version bump will happen when this PR is merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants