「todoist-python」ライブラリでタスクを取得する方法

本記事は、PythonでTodoistにプロジェクトやタスクを取得・追加する方法について説明するものです。

具体的には、
・「Python-todoist」ライブラリをインストールする手順
・TodoistのAPIトークンを取得する手順
・「Python-todoist」のコード記述例と実行例
の3つについて説明します。

Todoistから情報取得することで1日のタスクリストを自動作成したり、スケジュールに合わせて特定のスクリプトを自動的に動かしたりということも可能です。

合わせて読みたい

「PyTodoist」ライブラリでタスクを取得する方法

※2019/8/30にAPIバージョンがv8にアップデートされました。v7未対応のライブラリでは動作しないのでご注意ください。
v8の変更点については「TodoistのAPIのv8の主な変更点と対応方法」をお読みだくさい。

「Python-todoist」ライブラリをインストールする手順

「Python-todoist」ライブラリを使う方法を紹介します。
TodoistのAPIを操作するPythonライブラリが作られているのでこちらを利用します。

開発の際は「Todoistデベロッパーのドキュメント」も参考にしてください。

公式で紹介しているライブラリですが、「PyTodoist」と比較するとわかりにくく面倒なセットアップもいります。

「Python-todoist」のライブラリをインストール

pipコマンドで「todoist-python」ライブラリをインストールします。

pip install todoist-python

「Python-todoist」の環境設定

そのままではPython2では動きますが、Python3では動作しません。
ライブラリのドキュメントの手順に従って環境設定する必要があります。

基本的に書いてある内容をそのまま打ち込めばOKです。
GitHubから環境設定に必要なファイルをチェックアウトします。

$ git clone https://github.com/Doist/todoist-python.git

チェックアウトしたディレクトリに移動します。

$ cd todoist-python

virtualenvで仮想環境をセットアップします。

◆Macの場合
Macの場合はGitHubの手順通りでOKです。

$ pip install virtualenv
$ virtualenv –system-site-packages -p /usr/bin/python2.7 Env
$ source Env/bin/activate

◆Windowsの場合
Windowsの場合は、Python2.x系のインストール先の指定が必要です。Python3.x系しかインストールしていない場合はPython2.x系もインストールしてください。

>pip install virtualenv
>python -m virtualenv –python=C:\usr\local\bin\Python27\python.exe Env
>Env\Scripts\activate

Windowsのvirtualenvのセットアップ方法については以下の記事を参考にしてください。

参考：WindowsにPythonをインストール + pip + virtualenv

必要なライブラリをインストールします。

$ pip install -e .
$ pip install -r doc/requirements.txt

以上でセットアップは完了です。

TodoistのAPIトークンを取得する手順

自分の管理しているTodoistの情報を取得する為にはAPIトークンと呼ばれるキーを取得する必要があります。
APIトークンを取得する手順を説明します。

1.右上の歯車マークをクリックして「設定」をクリックします。

2.連携機能をクリックします。

3.APIトークンに記載されている内容をコピーします。

画面をスクロールすると「APIトークン」の項目があるのでこの文字列をひかえておきます。

「Python-todoist」のコード記述例と実行例

プロジェクトとタスクを追加するコードは以下の通りです。

from todoist.api import TodoistAPI
api_token = ”123456789abc(取得したAPIトークンを指定)”
# Todoistから情報を取得
api = TodoistAPI(api_token)
api.sync()
# プロジェクトを追加
project1 = api.projects.add('テストプロジェクト')
# タスクを追加
task1 = api.items.add('テストタスク', project1['id'])
# Todoistに反映する
api.commit()