microsoft-todo-cli 1.0.0__tar.gz → 1.2.0__tar.gz

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/CHANGES.txt

@@ -1,3 +1,12 @@
+v1.2.0, 2026-02-05
+  - Added -N/--note flag to 'new' command for creating tasks with notes
+
+v1.1.0, 2026-02-05
+  - Added note support: note, show-note, clear-note commands
+  - Added sn, cn aliases for show-note and clear-note
+  - Notes are now displayed in show command and JSON output
+  - Added note field to Task model
+
 v1.0.0, 2026-02-04
   - Fork from kiblee/tod0 with redesigned CLI
   - Removed interactive TUI, CLI-only

{microsoft_todo_cli-1.0.0/microsoft_todo_cli.egg-info → microsoft_todo_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-todo-cli
-Version: 1.0.0
+Version: 1.2.0
 Summary: Fast, minimal command-line client for Microsoft To-Do
 Home-page: https://github.com/underwear/microsoft-todo-cli
 Author: underwear
@@ -116,6 +116,7 @@ todo new "Task" -I                # Important
 todo new "Task" -R daily          # Recurring
 todo new "Task" -R weekly:mon,fri # Recurring on specific days
 todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+todo new "Task" -N "Note content"     # With note
 
 # View single task
 todo show "Task"                  # Show task details
@@ -141,6 +142,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -279,6 +290,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -287,6 +299,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/README.md

@@ -78,6 +78,7 @@ todo new "Task" -I                # Important
 todo new "Task" -R daily          # Recurring
 todo new "Task" -R weekly:mon,fri # Recurring on specific days
 todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+todo new "Task" -N "Note content"     # With note
 
 # View single task
 todo show "Task"                  # Show task details
@@ -103,6 +104,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -241,6 +252,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -249,6 +261,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0/microsoft_todo_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-todo-cli
-Version: 1.0.0
+Version: 1.2.0
 Summary: Fast, minimal command-line client for Microsoft To-Do
 Home-page: https://github.com/underwear/microsoft-todo-cli
 Author: underwear
@@ -116,6 +116,7 @@ todo new "Task" -I                # Important
 todo new "Task" -R daily          # Recurring
 todo new "Task" -R weekly:mon,fri # Recurring on specific days
 todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+todo new "Task" -N "Note content"     # With note
 
 # View single task
 todo show "Task"                  # Show task details
@@ -141,6 +142,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -279,6 +290,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -287,6 +299,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/microsoft_todo_cli.egg-info/SOURCES.txt

@@ -23,6 +23,8 @@ tests/test_filters.py
 tests/test_json_output.py
 tests/test_lst_output.py
 tests/test_models.py
+tests/test_note_cli.py
+tests/test_note_wrapper.py
 tests/test_odata_escape.py
 tests/test_recurrence.py
 tests/test_update_command.py

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/tests/test_cli_commands.py

@@ -129,6 +129,22 @@ class TestCLIArgumentParsing(unittest.TestCase):
         args = self.parser.parse_args(["new", "buy milk"])
         self.assertEqual(args.step, [])
 
+    def test_new_command_with_note_flag(self):
+        """Test 'new' command with -N flag"""
+        args = self.parser.parse_args(["new", "-N", "Remember to check prices", "buy milk"])
+        self.assertEqual(args.task_name, "buy milk")
+        self.assertEqual(args.note, "Remember to check prices")
+
+    def test_new_command_with_note_long_flag(self):
+        """Test 'new' command with --note flag"""
+        args = self.parser.parse_args(["new", "--note", "My note", "buy milk"])
+        self.assertEqual(args.note, "My note")
+
+    def test_new_command_without_note(self):
+        """Test 'new' command defaults note to None"""
+        args = self.parser.parse_args(["new", "buy milk"])
+        self.assertIsNone(args.note)
+
     def test_new_command_with_all_flags(self):
         """Test 'new' command with all flags"""
         args = self.parser.parse_args(

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/tests/test_models.py

@@ -230,6 +230,99 @@ class TestTaskModel(unittest.TestCase):
 
         self.assertIsNotNone(task.body_last_modified_datetime)
 
+    def test_task_with_note(self):
+        """Test task with note (body content)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "This is my note content",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "This is my note content")
+        self.assertEqual(task.note_content_type, "text")
+
+    def test_task_without_note(self):
+        """Test task without note (no body field)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task without note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "")
+        self.assertEqual(task.note_content_type, "text")
+
+    def test_task_with_empty_note(self):
+        """Test task with empty note (body with empty content)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with empty note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "")
+
+    def test_task_note_in_to_dict(self):
+        """Test that note is included in to_dict output"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "Note for JSON",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+        task_dict = task.to_dict()
+
+        self.assertIn("note", task_dict)
+        self.assertEqual(task_dict["note"], "Note for JSON")
+
+    def test_task_empty_note_in_to_dict(self):
+        """Test that empty note is None in to_dict output"""
+        api_response = {
+            "id": "task123",
+            "title": "Task without note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+        }
+        task = Task(api_response)
+        task_dict = task.to_dict()
+
+        self.assertIn("note", task_dict)
+        self.assertIsNone(task_dict["note"])
+
 
 if __name__ == "__main__":
     unittest.main()

microsoft_todo_cli-1.2.0/tests/test_note_cli.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""Unit tests for note CLI commands (argument parsing)"""
+
+import unittest
+from todocli.cli import setup_parser
+
+
+class TestNoteCLIArgParsing(unittest.TestCase):
+    """Test that CLI parsers correctly parse note command arguments"""
+
+    def setUp(self):
+        self.parser = setup_parser()
+
+    # note command
+
+    def test_note_basic(self):
+        """Test note command with task name and content"""
+        args = self.parser.parse_args(["note", "Buy groceries", "Remember to check prices"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.note_content, "Remember to check prices")
+
+    def test_note_with_list_flag(self):
+        """Test note command with --list flag"""
+        args = self.parser.parse_args(
+            ["note", "Buy groceries", "Remember to check prices", "-l", "Shopping"]
+        )
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.note_content, "Remember to check prices")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_note_with_id_flag(self):
+        """Test note command with --id flag"""
+        args = self.parser.parse_args(
+            ["note", "--id", "task123", "This is a note"]
+        )
+        self.assertEqual(args.task_id, "task123")
+        self.assertEqual(args.note_content, "This is a note")
+
+    def test_note_with_json_flag(self):
+        """Test note command with --json flag"""
+        args = self.parser.parse_args(
+            ["note", "Buy groceries", "Note content", "--json"]
+        )
+        self.assertTrue(args.json)
+
+    # show-note command
+
+    def test_show_note_basic(self):
+        """Test show-note command with task name"""
+        args = self.parser.parse_args(["show-note", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    def test_show_note_with_list_flag(self):
+        """Test show-note command with --list flag"""
+        args = self.parser.parse_args(["show-note", "Buy groceries", "-l", "Shopping"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_show_note_with_id_flag(self):
+        """Test show-note command with --id flag"""
+        args = self.parser.parse_args(["show-note", "--id", "task123"])
+        self.assertEqual(args.task_id, "task123")
+
+    def test_show_note_with_json_flag(self):
+        """Test show-note command with --json flag"""
+        args = self.parser.parse_args(["show-note", "Buy groceries", "--json"])
+        self.assertTrue(args.json)
+
+    def test_show_note_alias_sn(self):
+        """Test sn alias for show-note command"""
+        args = self.parser.parse_args(["sn", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    # clear-note command
+
+    def test_clear_note_basic(self):
+        """Test clear-note command with task name"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    def test_clear_note_with_list_flag(self):
+        """Test clear-note command with --list flag"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries", "-l", "Shopping"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_clear_note_with_id_flag(self):
+        """Test clear-note command with --id flag"""
+        args = self.parser.parse_args(["clear-note", "--id", "task123"])
+        self.assertEqual(args.task_id, "task123")
+
+    def test_clear_note_with_json_flag(self):
+        """Test clear-note command with --json flag"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries", "--json"])
+        self.assertTrue(args.json)
+
+    def test_clear_note_alias_cn(self):
+        """Test cn alias for clear-note command"""
+        args = self.parser.parse_args(["cn", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+
+if __name__ == "__main__":
+    unittest.main()

microsoft_todo_cli-1.2.0/tests/test_note_wrapper.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Unit tests for note wrapper functions"""
+
+import unittest
+from todocli.graphapi.wrapper import BASE_URL
+
+
+class TestNoteEndpointPattern(unittest.TestCase):
+    """Test that the note endpoint URL is correctly constructed"""
+
+    def test_task_endpoint_for_note_update(self):
+        """Test the task endpoint follows the expected pattern for note updates"""
+        list_id = "list123"
+        task_id = "task456"
+        endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+
+        self.assertIn(list_id, endpoint)
+        self.assertIn(task_id, endpoint)
+        self.assertTrue(endpoint.startswith("https://graph.microsoft.com"))
+        self.assertIn("/tasks/", endpoint)
+
+    def test_note_request_body_format(self):
+        """Test that note request body has correct structure"""
+        note_content = "Test note content"
+        content_type = "text"
+
+        request_body = {
+            "body": {
+                "content": note_content,
+                "contentType": content_type,
+            }
+        }
+
+        self.assertIn("body", request_body)
+        self.assertEqual(request_body["body"]["content"], note_content)
+        self.assertEqual(request_body["body"]["contentType"], content_type)
+
+    def test_clear_note_request_body_format(self):
+        """Test that clear note request body has correct structure (empty content)"""
+        request_body = {
+            "body": {
+                "content": "",
+                "contentType": "text",
+            }
+        }
+
+        self.assertIn("body", request_body)
+        self.assertEqual(request_body["body"]["content"], "")
+
+
+if __name__ == "__main__":
+    unittest.main()

microsoft_todo_cli-1.2.0/todocli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.2.0"

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/todocli/cli.py

@@ -152,6 +152,7 @@ def new(args):
         due_datetime = parse_datetime(due_date_time_str)
 
     recurrence = parse_recurrence(args.recurrence)
+    note_content = getattr(args, "note", None)
 
     task_id = wrapper.create_task(
         name,
@@ -160,6 +161,7 @@ def new(args):
         due_datetime=due_datetime,
         important=args.important,
         recurrence=recurrence,
+        note=note_content,
     )
 
     steps = getattr(args, "step", []) or []
@@ -175,6 +177,8 @@ def new(args):
     msg = f"Created task '{name}' in '{task_list}'"
     if steps:
         msg += f" with {len(steps)} step(s)"
+    if note_content:
+        msg += " with note"
 
     result = {
         "action": "created",
@@ -185,6 +189,8 @@ def new(args):
     }
     if step_ids:
         result["step_ids"] = step_ids
+    if note_content:
+        result["note"] = note_content
 
     _output_result(args, result)
 
@@ -837,6 +843,122 @@ def rm_step(args):
         print(result["message"])
 
 
+def note(args):
+    """Add or update a note on a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+    note_content = args.note_content
+
+    if task_id:
+        list_name = getattr(args, "list", None) or "Tasks"
+        returned_id, title, content = wrapper.update_task_note(
+            note_content=note_content,
+            list_name=list_name,
+            task_id=task_id,
+        )
+        result = {
+            "action": "updated",
+            "id": returned_id,
+            "title": title,
+            "note": content,
+            "list": list_name,
+            "message": f"Updated note on task '{title}'",
+        }
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        returned_id, title, content = wrapper.update_task_note(
+            note_content=note_content,
+            list_name=task_list,
+            task_name=try_parse_as_int(task_name),
+        )
+        result = {
+            "action": "updated",
+            "id": returned_id,
+            "title": title,
+            "note": content,
+            "list": task_list,
+            "message": f"Updated note on task '{title}' in '{task_list}'",
+        }
+
+    if use_json:
+        print(json.dumps(result, indent=2))
+    else:
+        print(result["message"])
+
+
+def show_note(args):
+    """Display the note of a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+
+    if task_id:
+        task_list = getattr(args, "list", None) or "Tasks"
+        task = wrapper.get_task(list_name=task_list, task_id=task_id)
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        task = wrapper.get_task(
+            list_name=task_list, task_name=try_parse_as_int(task_name)
+        )
+
+    if use_json:
+        output = {
+            "id": task.id,
+            "title": task.title,
+            "note": task.note if task.note else None,
+            "list": task_list,
+        }
+        print(json.dumps(output, indent=2))
+    else:
+        if task.note:
+            print(task.note)
+        else:
+            print(f"No note on task '{task.title}'")
+
+
+def clear_note(args):
+    """Clear the note from a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+
+    if task_id:
+        list_name = getattr(args, "list", None) or "Tasks"
+        returned_id, title = wrapper.clear_task_note(
+            list_name=list_name,
+            task_id=task_id,
+        )
+        result = {
+            "action": "cleared",
+            "id": returned_id,
+            "title": title,
+            "list": list_name,
+            "message": f"Cleared note from task '{title}'",
+        }
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        returned_id, title = wrapper.clear_task_note(
+            list_name=task_list,
+            task_name=try_parse_as_int(task_name),
+        )
+        result = {
+            "action": "cleared",
+            "id": returned_id,
+            "title": title,
+            "list": task_list,
+            "message": f"Cleared note from task '{title}' in '{task_list}'",
+        }
+
+    if use_json:
+        print(json.dumps(result, indent=2))
+    else:
+        print(result["message"])
+
+
 def show(args):
     """Display all details of a task."""
     task_id = getattr(args, "task_id", None)
@@ -875,6 +997,8 @@ def show(args):
         if task.reminder_datetime:
             print(f"Reminder:   {task.reminder_datetime.strftime('%Y-%m-%d %H:%M')}")
         print(f"Created:    {format_date(task.created_datetime, date_fmt)}")
+        if task.note:
+            print(f"Note:       {task.note}")
         if steps:
             print("Steps:")
             for i, step in enumerate(steps):
@@ -1082,6 +1206,12 @@ def setup_parser():
             default=[],
             help="Add a step (checklist item); can be repeated",
         )
+        subparser.add_argument(
+            "-N",
+            "--note",
+            help="Add a note to the task",
+            metavar="TEXT",
+        )
         _add_list_flag(subparser)
         _add_json_flag(subparser)
         subparser.set_defaults(func=new)
@@ -1272,6 +1402,39 @@ def setup_parser():
     _add_json_flag(subparser)
     subparser.set_defaults(func=rm_step)
 
+    # 'note' command - add or update a note on a task
+    subparser = subparsers.add_parser("note", help="Add or update a note on a task")
+    subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+    subparser.add_argument("note_content", help="Note content to add to the task")
+    _add_list_flag(subparser)
+    _add_id_flag(subparser)
+    _add_json_flag(subparser)
+    subparser.set_defaults(func=note)
+
+    # 'show-note' command (primary) and 'sn' alias
+    for cmd_name in ["show-note", "sn"]:
+        subparser = subparsers.add_parser(
+            cmd_name,
+            help="Display the note of a task" if cmd_name == "show-note" else argparse.SUPPRESS,
+        )
+        subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+        _add_list_flag(subparser)
+        _add_id_flag(subparser)
+        _add_json_flag(subparser)
+        subparser.set_defaults(func=show_note)
+
+    # 'clear-note' command (primary) and 'cn' alias
+    for cmd_name in ["clear-note", "cn"]:
+        subparser = subparsers.add_parser(
+            cmd_name,
+            help="Clear the note from a task" if cmd_name == "clear-note" else argparse.SUPPRESS,
+        )
+        subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+        _add_list_flag(subparser)
+        _add_id_flag(subparser)
+        _add_json_flag(subparser)
+        subparser.set_defaults(func=clear_note)
+
     return parser
 
 

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/todocli/graphapi/wrapper.py

@@ -172,6 +172,7 @@ def create_task(
     due_datetime: datetime | None = None,
     important: bool = False,
     recurrence: dict | None = None,
+    note: str | None = None,
 ):
     _require_list(list_name, list_id)
 
@@ -191,6 +192,8 @@ def create_task(
         "importance": TaskImportance.HIGH if important else TaskImportance.NORMAL,
         "recurrence": recurrence,
     }
+    if note:
+        request_body["body"] = {"content": note, "contentType": "text"}
     session = get_oauth_session()
     response = session.post(endpoint, json=request_body)
     if response.ok:
@@ -658,3 +661,69 @@ def get_step_id(
         raise StepNotFoundByName(step_name, task_name)
     else:
         raise TypeError(f"step_name must be str or int, got {type(step_name).__name__}")
+
+
+# --- Note functions ---
+
+
+def update_task_note(
+    note_content: str,
+    list_name: str = None,
+    task_name: Union[str, int] = None,
+    list_id: str = None,
+    task_id: str = None,
+    content_type: str = "text",
+):
+    """Update the note (body) of a task. Returns (task_id, task_title, note_content)."""
+    _require_list(list_name, list_id)
+    _require_task(task_name, task_id)
+
+    if list_id is None:
+        list_id = get_list_id_by_name(list_name)
+    if task_id is None:
+        task_id = get_task_id_by_name(list_name, task_name)
+
+    endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+    request_body = {
+        "body": {
+            "content": note_content,
+            "contentType": content_type,
+        }
+    }
+    session = get_oauth_session()
+    response = session.patch(endpoint, json=request_body)
+    if response.ok:
+        data = json.loads(response.content.decode())
+        body = data.get("body", {})
+        return task_id, data.get("title", ""), body.get("content", "")
+    response.raise_for_status()
+
+
+def clear_task_note(
+    list_name: str = None,
+    task_name: Union[str, int] = None,
+    list_id: str = None,
+    task_id: str = None,
+):
+    """Clear the note (body) of a task. Returns (task_id, task_title)."""
+    _require_list(list_name, list_id)
+    _require_task(task_name, task_id)
+
+    if list_id is None:
+        list_id = get_list_id_by_name(list_name)
+    if task_id is None:
+        task_id = get_task_id_by_name(list_name, task_name)
+
+    endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+    request_body = {
+        "body": {
+            "content": "",
+            "contentType": "text",
+        }
+    }
+    session = get_oauth_session()
+    response = session.patch(endpoint, json=request_body)
+    if response.ok:
+        data = json.loads(response.content.decode())
+        return task_id, data.get("title", "")
+    response.raise_for_status()

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.2.0}/todocli/models/todotask.py

@@ -77,6 +77,14 @@ class Task:
         else:
             self.body_last_modified_datetime = None
 
+        # Note (body content)
+        if "body" in query_result and query_result["body"]:
+            self.note = query_result["body"].get("content", "")
+            self.note_content_type = query_result["body"].get("contentType", "text")
+        else:
+            self.note = ""
+            self.note_content_type = "text"
+
     def to_dict(self):
         """Convert task to dictionary for JSON serialization."""
         return {
@@ -85,6 +93,7 @@ class Task:
             "status": self.status.value,
             "importance": self.importance.value,
             "is_reminder_on": self.is_reminder_on,
+            "note": self.note if self.note else None,
             "created_datetime": (
                 self.created_datetime.isoformat() if self.created_datetime else None
             ),

microsoft_todo_cli-1.0.0/todocli/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.0.0"