add added/changed task date support and release notes for 1.1.5

implement added/changed date filters and payload fields across python/typescript/rust, document the new capabilities, and bump rust package metadata to 1.1.5 with changelog updates.

Made-with: Cursor

Author: vitalyrodnenko

CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [1.1.5] - 2026-03-05
+
+### Added
+- support task date filters for creation/last-modified dates:
+  - `added_after`, `added_before`
+  - `changed_after`, `changed_before` (`changed` maps to OmniFocus `modified`)
+- include `addedDate` and `changedDate` in task payloads returned by read tools
+
+### Changed
+- updated documentation in root, Python, TypeScript, and Rust READMEs to describe
+  the new date filters and task date fields
+- bumped Rust package metadata from `1.1.4` to `1.1.5`
+
+## [1.1.4] - 2026-03-03
+
+### Fixed
+- perspective enumeration now includes built-in, custom, and document perspectives
+  so completed and custom perspectives are returned correctly
+
+### Added
+- batch deletion tools for projects, tags, and folders with partial-success output:
+  - `delete_projects_batch`
+  - `delete_tags_batch`
+  - `delete_folders_batch`

README.md

@@ -68,6 +68,8 @@ Full lifecycle management for OmniFocus tasks:
 | `dueBefore` / `dueAfter` | Due date range (ISO 8601) |
 | `deferBefore` / `deferAfter` | Defer date range (ISO 8601) |
 | `completedBefore` / `completedAfter` | Completion date range (ISO 8601) |
+| `addedBefore` / `addedAfter` | Creation date range (ISO 8601) |
+| `changedBefore` / `changedAfter` | Last-modified date range (ISO 8601, maps to OmniFocus `modified`) |
 | `plannedBefore` / `plannedAfter` | Planned date range (ISO 8601) |
 | `maxEstimatedMinutes` | Tasks with estimated duration up to N minutes |
 
@@ -77,6 +79,7 @@ All list/search tools support `sortBy` and `sortOrder`:
 
 - Sort by: `name`, `due`, `defer`, `added`, `modified`, `completed`, `estimated`, `planned`
 - Sort order: `asc` (default) or `desc`
+- Task payloads include `addedDate` and `changedDate` (ISO 8601 or `null`)
 
 ### Projects (11 tools)
 

python/README.md

@@ -98,10 +98,14 @@ Once connected from your MCP client, try:
 
 - `ping` to verify server health
 - `get_inbox` to retrieve current inbox tasks
-- `list_tasks` with filters such as `status="due_soon"`
+- `list_tasks` with filters such as `status="due_soon"` or date ranges (`added_after`, `added_before`, `changed_after`, `changed_before`)
 - `create_task` to add an inbox or project task
 - `project_planning` prompt to generate a structured plan from project state
 
+Task payloads returned by read tools include:
+- `addedDate` (task creation timestamp, ISO 8601 or `null`)
+- `changedDate` (task last-modified timestamp, ISO 8601 or `null`; maps to OmniFocus `modified`)
+
 ## Development Checks
 
 Run the Python checks:

python/src/omnifocus_mcp/tools/tasks.py

@@ -84,6 +84,8 @@ async def test_get_inbox_happy_path(
             "name": "Inbox Task",
             "note": "n",
             "flagged": False,
+            "addedDate": "2026-02-01T09:00:00Z",
+            "changedDate": "2026-02-03T10:30:00Z",
             "dueDate": None,
             "deferDate": None,
             "completionDate": None,
@@ -116,6 +118,13 @@ async def test_get_inbox_happy_path(
         "completionDate: task.completionDate ? task.completionDate.toISOString() : null,"
         in state["calls"][0]["script"]
     )
+    assert "addedDate: task.added ? task.added.toISOString() : null," in state["calls"][0][
+        "script"
+    ]
+    assert (
+        "changedDate: task.modified ? task.modified.toISOString() : null,"
+        in state["calls"][0]["script"]
+    )
     assert "hasChildren: task.hasChildren" in state["calls"][0]["script"]
     assert "taskStatus: (() => {" in state["calls"][0]["script"]
     assert 'if (s.includes("Dropped")) return "dropped";' in state["calls"][0]["script"]
@@ -278,6 +287,8 @@ async def test_list_tasks_happy_path(
             "name": "Task",
             "note": "note",
             "flagged": True,
+            "addedDate": "2026-02-01T09:00:00Z",
+            "changedDate": "2026-02-05T10:30:00Z",
             "dueDate": "2026-03-01T10:00:00Z",
             "deferDate": None,
             "completed": False,
@@ -309,6 +320,13 @@ async def test_list_tasks_happy_path(
         "plannedDate: plannedDate ? plannedDate.toISOString() : null,"
         in state["calls"][0]["script"]
     )
+    assert "addedDate: task.added ? task.added.toISOString() : null," in state["calls"][0][
+        "script"
+    ]
+    assert (
+        "changedDate: task.modified ? task.modified.toISOString() : null,"
+        in state["calls"][0]["script"]
+    )
     assert "hasChildren: task.hasChildren" in state["calls"][0]["script"]
     assert 'if (s.includes("Available")) return "available";' in state["calls"][0]["script"]
     assert ".slice(0, 7)" in state["calls"][0]["script"]
@@ -362,6 +380,46 @@ async def test_list_tasks_date_filters_are_included_in_script(
     assert ".slice(0, 9)" in script
 
 
+@pytest.mark.asyncio
+async def test_list_tasks_added_changed_date_filters_are_included_in_script(
+    mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
+) -> None:
+    configured = mock_server_run_omnijs([])
+    state = configured["state"]
+    server = configured["server"]
+
+    await server.list_tasks(
+        added_after="2026-02-01T00:00:00Z",
+        added_before="2026-02-28T23:59:59Z",
+        changed_after="2026-03-01T00:00:00Z",
+        changed_before="2026-03-31T23:59:59Z",
+        limit=5,
+    )
+
+    script = state["calls"][0]["script"]
+    assert 'const addedAfterRaw = "2026-02-01T00:00:00Z";' in script
+    assert 'const addedBeforeRaw = "2026-02-28T23:59:59Z";' in script
+    assert 'const changedAfterRaw = "2026-03-01T00:00:00Z";' in script
+    assert 'const changedBeforeRaw = "2026-03-31T23:59:59Z";' in script
+    assert (
+        "if (addedBefore !== null && !(task.added !== null && task.added <= addedBefore)) return false;"
+        in script
+    )
+    assert (
+        "if (addedAfter !== null && !(task.added !== null && task.added >= addedAfter)) return false;"
+        in script
+    )
+    assert (
+        "if (changedBefore !== null && !(task.modified !== null && task.modified <= changedBefore)) return false;"
+        in script
+    )
+    assert (
+        "if (changedAfter !== null && !(task.modified !== null && task.modified >= changedAfter)) return false;"
+        in script
+    )
+    assert ".slice(0, 5)" in script
+
+
 @pytest.mark.asyncio
 async def test_list_tasks_completed_date_filter_auto_includes_completed_logic(
     mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
@@ -606,6 +664,44 @@ async def test_get_task_counts_includes_filters_and_aggregate_counters_in_script
     assert json.loads(result)["total"] == 4
 
 
+@pytest.mark.asyncio
+async def test_get_task_counts_added_changed_date_filters_are_included_in_script(
+    mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
+) -> None:
+    configured = mock_server_run_omnijs({"total": 0})
+    state = configured["state"]
+    server = configured["server"]
+
+    await server.get_task_counts(
+        added_after="2026-02-01T00:00:00Z",
+        added_before="2026-02-28T23:59:59Z",
+        changed_after="2026-03-01T00:00:00Z",
+        changed_before="2026-03-31T23:59:59Z",
+    )
+
+    script = state["calls"][0]["script"]
+    assert 'const addedAfterRaw = "2026-02-01T00:00:00Z";' in script
+    assert 'const addedBeforeRaw = "2026-02-28T23:59:59Z";' in script
+    assert 'const changedAfterRaw = "2026-03-01T00:00:00Z";' in script
+    assert 'const changedBeforeRaw = "2026-03-31T23:59:59Z";' in script
+    assert (
+        "if (addedBefore !== null && !(task.added !== null && task.added <= addedBefore)) continue;"
+        in script
+    )
+    assert (
+        "if (addedAfter !== null && !(task.added !== null && task.added >= addedAfter)) continue;"
+        in script
+    )
+    assert (
+        "if (changedBefore !== null && !(task.modified !== null && task.modified <= changedBefore)) continue;"
+        in script
+    )
+    assert (
+        "if (changedAfter !== null && !(task.modified !== null && task.modified >= changedAfter)) continue;"
+        in script
+    )
+
+
 @pytest.mark.asyncio
 async def test_get_task_happy_path(
     mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
@@ -615,6 +711,8 @@ async def test_get_task_happy_path(
         "name": "Task 3",
         "note": "",
         "flagged": False,
+        "addedDate": "2026-02-01T09:00:00Z",
+        "changedDate": "2026-02-06T11:00:00Z",
         "dueDate": None,
         "deferDate": None,
         "effectiveDueDate": None,
@@ -646,6 +744,13 @@ async def test_get_task_happy_path(
     assert "effectiveDueDate: task.effectiveDueDate ? task.effectiveDueDate.toISOString() : null," in state["calls"][0]["script"]
     assert "effectiveDeferDate: task.effectiveDeferDate ? task.effectiveDeferDate.toISOString() : null," in state["calls"][0]["script"]
     assert "effectiveFlagged: task.effectiveFlagged," in state["calls"][0]["script"]
+    assert "addedDate: task.added ? task.added.toISOString() : null," in state["calls"][0][
+        "script"
+    ]
+    assert (
+        "changedDate: task.modified ? task.modified.toISOString() : null,"
+        in state["calls"][0]["script"]
+    )
     assert "modified: task.modified ? task.modified.toISOString() : null," in state["calls"][0]["script"]
     assert "plannedDate: plannedDate ? plannedDate.toISOString() : null," in state["calls"][0]["script"]
     assert "effectivePlannedDate: effectivePlannedDate ? effectivePlannedDate.toISOString() : null," in state["calls"][0]["script"]
@@ -899,6 +1004,8 @@ async def test_search_tasks_happy_path(
             "name": "Buy milk",
             "note": "fridge",
             "flagged": False,
+            "addedDate": "2026-02-01T09:00:00Z",
+            "changedDate": "2026-02-08T12:00:00Z",
             "dueDate": None,
             "deferDate": None,
             "completed": False,
@@ -928,6 +1035,13 @@ async def test_search_tasks_happy_path(
         "plannedDate: plannedDate ? plannedDate.toISOString() : null,"
         in state["calls"][0]["script"]
     )
+    assert "addedDate: task.added ? task.added.toISOString() : null," in state["calls"][0][
+        "script"
+    ]
+    assert (
+        "changedDate: task.modified ? task.modified.toISOString() : null,"
+        in state["calls"][0]["script"]
+    )
     assert "hasChildren: task.hasChildren" in state["calls"][0]["script"]
     assert "taskStatus: (() => {" in state["calls"][0]["script"]
     assert 'if (s.includes("DueSoon")) return "due_soon";' in state["calls"][0]["script"]
@@ -954,6 +1068,46 @@ async def test_search_tasks_with_project_filter_uses_combined_filters(
     )
 
 
+@pytest.mark.asyncio
+async def test_search_tasks_added_changed_date_filters_are_included_in_script(
+    mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
+) -> None:
+    configured = mock_server_run_omnijs([{"id": "t-changed", "name": "task"}])
+    state = configured["state"]
+    server = configured["server"]
+
+    await server.search_tasks(
+        query="shape",
+        added_after="2026-02-01T00:00:00Z",
+        added_before="2026-02-28T23:59:59Z",
+        changed_after="2026-03-01T00:00:00Z",
+        changed_before="2026-03-31T23:59:59Z",
+        limit=4,
+    )
+    script = state["calls"][0]["script"]
+    assert 'const addedAfterRaw = "2026-02-01T00:00:00Z";' in script
+    assert 'const addedBeforeRaw = "2026-02-28T23:59:59Z";' in script
+    assert 'const changedAfterRaw = "2026-03-01T00:00:00Z";' in script
+    assert 'const changedBeforeRaw = "2026-03-31T23:59:59Z";' in script
+    assert (
+        "if (addedBefore !== null && !(task.added !== null && task.added <= addedBefore)) return false;"
+        in script
+    )
+    assert (
+        "if (addedAfter !== null && !(task.added !== null && task.added >= addedAfter)) return false;"
+        in script
+    )
+    assert (
+        "if (changedBefore !== null && !(task.modified !== null && task.modified <= changedBefore)) return false;"
+        in script
+    )
+    assert (
+        "if (changedAfter !== null && !(task.modified !== null && task.modified >= changedAfter)) return false;"
+        in script
+    )
+    assert ".slice(0, 4)" in script
+
+
 @pytest.mark.asyncio
 async def test_search_tasks_with_completed_after_auto_includes_completed_and_auto_sort(
     mock_server_run_omnijs: Callable[[Any], dict[str, Any]],
@@ -1452,6 +1606,63 @@ async def fake_run_omnijs(script: str, timeout_seconds: float = 30.0) -> Any:
         await server_module.get_task_counts(dueBefore="bad-date")
 
 
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "field_name",
+    ["added_after", "added_before", "changed_after", "changed_before"],
+)
+async def test_list_tasks_new_date_filters_invalid_date_error_bubbles_up(
+    server_module: Any, monkeypatch: pytest.MonkeyPatch, field_name: str
+) -> None:
+    async def fake_run_omnijs(script: str, timeout_seconds: float = 30.0) -> Any:
+        raise RuntimeError(f"{field_name} must be a valid ISO 8601 date string.")
+
+    _patch_run_omnijs(monkeypatch, server_module, fake_run_omnijs)
+
+    with pytest.raises(
+        RuntimeError, match=rf"{field_name} must be a valid ISO 8601 date string."
+    ):
+        await server_module.list_tasks(**{field_name: "bad-date"})
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "field_name",
+    ["added_after", "added_before", "changed_after", "changed_before"],
+)
+async def test_search_tasks_new_date_filters_invalid_date_error_bubbles_up(
+    server_module: Any, monkeypatch: pytest.MonkeyPatch, field_name: str
+) -> None:
+    async def fake_run_omnijs(script: str, timeout_seconds: float = 30.0) -> Any:
+        raise RuntimeError(f"{field_name} must be a valid ISO 8601 date string.")
+
+    _patch_run_omnijs(monkeypatch, server_module, fake_run_omnijs)
+
+    with pytest.raises(
+        RuntimeError, match=rf"{field_name} must be a valid ISO 8601 date string."
+    ):
+        await server_module.search_tasks(query="shape", **{field_name: "bad-date"})
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "field_name",
+    ["added_after", "added_before", "changed_after", "changed_before"],
+)
+async def test_get_task_counts_new_date_filters_invalid_date_error_bubbles_up(
+    server_module: Any, monkeypatch: pytest.MonkeyPatch, field_name: str
+) -> None:
+    async def fake_run_omnijs(script: str, timeout_seconds: float = 30.0) -> Any:
+        raise RuntimeError(f"{field_name} must be a valid ISO 8601 date string.")
+
+    _patch_run_omnijs(monkeypatch, server_module, fake_run_omnijs)
+
+    with pytest.raises(
+        RuntimeError, match=rf"{field_name} must be a valid ISO 8601 date string."
+    ):
+        await server_module.get_task_counts(**{field_name: "bad-date"})
+
+
 @pytest.mark.asyncio
 async def test_list_subtasks_empty_task_id_validation_error(server_module: Any) -> None:
     with pytest.raises(ValueError, match="task_id must not be empty"):

python/tests/test_tools_read.py

@@ -13,7 +13,7 @@
 
 [package]
 name = "omnifocus-mcp"
-version = "1.1.4"
+version = "1.1.5"
 edition = "2021"
 license = "MIT"
 

rust/Cargo.lock

@@ -7,11 +7,16 @@ compiled binary (`omnifocus-mcp`) distributable via Homebrew.
 
 - 40 tools, 3 resources, 4 prompts — full API parity with Python and TypeScript
 - Advanced read-side filtering and sorting on tasks/projects (date ranges, multi-tag modes, stalled detection)
+- Added/changed task date filtering (`added_*`, `changed_*`) for list/search/count read tools
 - Aggregate count tools (`get_task_counts`, `get_project_counts`) for fast "how many" queries
 - Single binary, zero runtime dependencies
 - ~5 MB release build
 - Homebrew-installable (`brew install omnifocus-mcp`)
 
+Task payloads returned by read tools include:
+- `addedDate` (task creation timestamp, ISO 8601 or `null`)
+- `changedDate` (task last-modified timestamp, ISO 8601 or `null`; maps to OmniFocus `modified`)
+
 ## Prerequisites
 
 - macOS (required — uses `osascript` for OmniFocus communication)