Skip to main content

Unofficial Microsoft To-Do python library

Project description

Table of contents


Pymtodo is an unofficial Microsoft To-Do python library which allows managing your tasks. It can help you to optimize your workflow and create long lists (for example, if you read books and like to check it in your To-Do list).


You can install pymtodo via pip:

$ git clone
$ pip install pymtodo

Quick start


Pymtodo is very easy to use. First, you need to be authorized in the Microsoft To-Do system:

from pymtodo import ToDoConnection
from getpass import getpass

a = ToDoConnection()
a.connect(email = '', password = getpass())

Getpass package allows you to write your password in the secure way, so noone will see it. Alternatively, you can just type it directly.

Get lists and tasks

In order to get all your lists you can just type:


To get the tasks for the particular list, you can write:


Create lists and tasks

You can create lists by using

a.create_list("New list")

and new tasks can be created in the particluar list:

a.lists[0].create_task("New task")

Delete lists and tasks

You can delete your lists and tasks by the delete method:


Be careful, there will not be a warning message.


Detailed documentation will be available soon.


Pymtodo is an unofficial, open source, third-party, free app and is not affiliated in any way with Microsoft.


Pymtodo is distributed under the MIT license.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymtodo-0.2.tar.gz (5.9 kB view hashes)

Uploaded source

Built Distribution

pymtodo-0.2-py3-none-any.whl (6.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page