Skip to main content

Todoist API Python Client

This is the official Python SDK for the Todoist API.

Installation

pip install todoist-api-python

Or add the project as a dependency in pyproject.toml:

dependencies = [
  "todoist-api-python>=3.1.0,<4",
]

Supported Python Versions

Python version 3.9 and above.

Usage

Here's an example of initializing the API client, fetching a task, and paginating through its comments:

from todoist_api_python.api import TodoistAPI

api = TodoistAPI("YOUR_API_TOKEN")

task = api.get_task("6X4Vw2Hfmg73Q2XR")
print(f"Task: {task.content}")

comments_iter = api.get_comments(task_id=task.id)
for comments in comments_iter:
    for comment in comments:
        print(f"Comment: {comment.content}")

Documentation

For more detailed reference documentation, have a look at the SDK documentation and the API documentation.

Development

To install Python dependencies:

$ uv sync

To install pre-commit:

$ uv run pre-commit install

You can try your changes via REPL by running:

$ uv run python

You can then import the library as described in Usage without having to create a file. If you decide to use TodoistAPIAsync, please keep in mind that you have to import asyncio and run asyncio.run(yourmethod()) to make your async methods run as expected.

Releases

This API client is public, and available in a PyPI repository.

A new update is automatically released by GitHub Actions, by creating a release with a tag in the format vX.Y.Z (v<Major>.<Minor>.<Patch>).

Users of the API client can then update to the new version in their pyproject.toml file.

Feedback

Any feedback, bugs, questions, comments, etc., can be reported as Issues in this repository.

Contributions

We would love contributions! Pull requests are welcome.

Metadata

Release files for todoist_api_python 3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for todoist_api_python 3.2.0
File Size Uploaded Provenance Actions
todoist_api_python-3.2.0.tar.gz 20.7 kB Without provenance Details for todoist_api_python-3.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for todoist_api_python 3.2.0
File Interpreter ABI Platform Actions
todoist_api_python-3.2.0-py3-none-any.whl Python 3 none any Details for todoist_api_python-3.2.0-py3-none-any.whl

Total release size: 44.2 kB

Release files / todoist_api_python-3.2.0.tar.gz

Download URL todoist_api_python-3.2.0.tar.gz
Size 20.7 kB
Tags Source
SHA-256 checksum
How to use checksums
442473921e283a2636a7896c3b2422938e299e3684e2979e5a467e8a239ff41a
BLAKE2b-256 checksum
How to use checksums
d5ec74132dd24c048db4697ac25b5ada74336360c3325780d4226c6a8b4d8e03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.11

Release files / todoist_api_python-3.2.0-py3-none-any.whl

Download URL todoist_api_python-3.2.0-py3-none-any.whl
Size 23.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f167bdcb2fb11f8970930ca466a3da92ee8e19a76df31418528c96564683f226
BLAKE2b-256 checksum
How to use checksums
7a4d6d10d2c7734b4e801b3c0599de060444e3dae7a131b61891d3860567b0a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.11

Security for todoist_api_python 3.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page