0
# Tasks and Planning
1

2
Microsoft To-Do and Planner integration for task management, project planning, bucket organization, and progress tracking.
3

4
## Capabilities
5

6
### Tasks (Microsoft To-Do)
7

8
```python { .api }
9
def tasks(self, resource: str = None) -> ToDo:
10
    """Get a ToDo instance for Microsoft To-Do operations."""
11

12
class ToDo:
13
    def get_lists(self) -> list[TaskList]:
14
        """Get task lists."""
15
    
16
    def new_list(self, list_name: str) -> TaskList:
17
        """Create a new task list."""
18

19
class TaskList:
20
    @property
21
    def display_name(self) -> str:
22
        """List display name."""
23
    
24
    def get_tasks(self) -> list[Task]:
25
        """Get tasks in this list."""
26
    
27
    def new_task(self, subject: str) -> Task:
28
        """Create a new task."""
29

30
class Task:
31
    @property
32
    def subject(self) -> str:
33
        """Task subject."""
34
    
35
    @property
36
    def completed(self) -> bool:
37
        """Whether task is completed."""
38
    
39
    def complete(self) -> bool:
40
        """Mark task as completed."""
41
```
42

43
### Planner
44

45
```python { .api }
46
def planner(self, resource: str = None) -> Planner:
47
    """Get a Planner instance for Microsoft Planner operations."""
48

49
class Planner:
50
    def get_plans(self) -> list[Plan]:
51
        """Get accessible plans."""
52

53
class Plan:
54
    @property
55
    def title(self) -> str:
56
        """Plan title."""
57
    
58
    def get_tasks(self) -> list[PlannerTask]:
59
        """Get plan tasks."""
60
    
61
    def get_buckets(self) -> list[Bucket]:
62
        """Get plan buckets."""
63
```
64

65
## Usage Examples
66

67
```python
68
account = Account(credentials)
69

70
# Work with To-Do tasks
71
todo = account.tasks()
72
task_lists = todo.get_lists()
73

74
for task_list in task_lists:
75
    tasks = task_list.get_tasks()
76
    print(f"List '{task_list.display_name}': {len(tasks)} tasks")
77

78
# Work with Planner
79
planner = account.planner()
80
plans = planner.get_plans()
81

82
for plan in plans:
83
    print(f"Plan: {plan.title}")
84
```