docs: document recent list/schedule/timezone improvements - #152
Merged
Conversation
Update the CHANGELOG [Unreleased] section and README for the changes shipped since the #132-#141 wave: - #151: account timezone + today's local date header on list/schedule responses - #149: list_all_uncompleted honors dueDate/priority; list gains completedAfter/completedBefore; schedule working hours; motion_statuses in the essential tier - #148: dueDate filter reduced to account-zone calendar date - wrangler observability logs enabled README: add list_all_uncompleted to motion_tasks operations, describe the new dueDate/completion filters and the timezone header, and correct the motion_schedules description to match the tool (working-hour templates, not calendar events). Claude-Session: https://claude.ai/code/session_01HbZLaLAKnrR3ZoZkZUk1Dn
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
Only minor documentation wording/staleness nits were found; no functional or structural issues block merge.
Pull request overview
Updates repository documentation to reflect recently shipped Motion task listing/scheduling improvements and tool-tier changes, keeping public docs aligned with behavior introduced across the #132–#151 PR wave.
Changes:
- Documented
motion_taskslist_all_uncompletedoperation and clarifieddueDate/ completion-date filter semantics and timezone header behavior. - Corrected
motion_schedulesREADME description to match working-hours template output. - Expanded the
[Unreleased]CHANGELOG with an ✨ Added section and adueDatebug-fix entry summarizing shipped behavior.
File summaries
| File | Description |
|---|---|
| README.md | Updates tool reference docs for motion_tasks and motion_schedules, including new ops and clarified filter/timezone semantics. |
| CHANGELOG.md | Adds an ✨ Added section and a new bug-fix bullet documenting timezone/date context and dueDate filtering fixes. |
Review details
- Files reviewed: 2/2 changed files
- Comments generated: 2
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
|
|
||
| ### ✨ Added | ||
|
|
||
| - **Account timezone and today's date on list responses**: task-list responses (`list`, `list_all_uncompleted`) and schedule responses now begin with a one-line header, e.g. `Account timezone: America/Denver | Today: 2026-08-24 (Monday)`. Date-relative reasoning the model does itself (weekday, "now") previously had nothing in the payload naming the account's zone, so fresh agents inferred "now" from the newest `updatedTime` and sometimes reported the wrong day. The zone is already resolved for rendering, so this adds no API calls, and it lands on both the stdio and Worker entry points. (#151, closes #150) |
|
|
||
| The primary tool for task management. Supports all Motion API parameters including `name`, `description`, `priority`, `dueDate`, `duration`, `labels`, `assigneeId`, and `autoScheduled`. You can reference workspaces and projects by name — the server resolves them automatically. | ||
|
|
||
| `list_all_uncompleted` spans every workspace in one call (it ignores `workspaceId`/`workspaceName`) and honors the `dueDate` and `priority` filters, so "what's due this week across all my workspaces?" resolves directly. On `list`, `dueDate` is an inclusive on-or-before-day bound that includes overdue tasks (so `dueDate: "today"` answers "what's due today?"), and `completedAfter` / `completedBefore` bound by completion date in your account's time zone for "what did I get done this week?". Dates are interpreted in your Motion account's time zone, and list responses lead with a header naming that zone and today's local date. |
ReviewDocs-only PR, verified against
No code changes, so no bugs/perf/security concerns to raise there. A couple of very minor nits, neither blocking:
Nice catch on the stale Overall: accurate, well-scoped, no issues found. Approving from a docs-accuracy standpoint. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the CHANGELOG
[Unreleased]section and the README for the changes shipped since the #132–#141 wave. Docs only, no code changes.CHANGELOG (
[Unreleased])New ✨ Added section plus one 🐛 Bug Fixes entry:
list_all_uncompletedhonorsdueDate/priority;listgainscompletedAfter/completedBefore; schedule responses print working hours;motion_statusesmoved to theessentialtier (now 8 tools)dueDatefilter reduced to account-zone calendar date (fixes same-day drop west of UTC)wrangler.tomlREADME
list_all_uncompletedto themotion_tasksoperations (it was in CLAUDE.md but missing here)dueDateon-or-before semantics,completedAfter/completedBefore, and the timezone headermotion_schedulesdescription to match the tool: working-hour templates with per-day hours, not calendar events / free-busyhttps://claude.ai/code/session_01HbZLaLAKnrR3ZoZkZUk1Dn