todoist_api_python

What it is and what it does

This is the official Python SDK for Todoist, maintained by Doist. It wraps the Todoist REST API and provides both synchronous and asynchronous interfaces for managing tasks, projects, comments, and other Todoist resources. The package depends on httpx for HTTP communication, annotated-types for type hints, and dataclass-wizard for data serialization.

Version 4.0.0 migrated the HTTP stack from requests to httpx, which is a breaking change for users upgrading from 3.x. The API client accepts an API token and returns typed objects representing Todoist entities. It supports pagination through iterators and offers async variants via TodoistAPIAsync for non-blocking I/O.

Use it for:

• Build task automation workflows that read and write to Todoist from Python applications
• Integrate Todoist data into dashboards or reporting tools via the synchronous API
• Create async task processors that fetch and update Todoist tasks without blocking
• Migrate or sync Todoist data to external systems or databases
• Develop Todoist bots or integrations that respond to external events

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Official Python SDK for the Todoist API, providing synchronous and asynchronous clients to interact with Todoist tasks, projects, and comments.

Yes. The package is the official SDK, actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. It is suitable for production use in Todoist integrations. Upgrading to 4.0.0 requires code changes if migrating from 3.x due to the httpx migration, but the breaking change is well-documented.

Install

todoist-api-python on PyPI

pip install todoist-api-python

uv add todoist-api-python

poetry add todoist-api-python

Installing todoist_api_python

Before you install

Low install friction with a pure Python wheel distribution. Actively maintained with recent releases; last commit on 2026-08-14 and 251 repository stars indicate ongoing development.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.

Quickstart

pip install todoist-api-python

from todoist_api_python.api import TodoistAPI

api = TodoistAPI("YOUR_API_TOKEN")
task = api.get_task("6X4Vw2Hfmg73Q2XR")
print(task.content)

Requires Python 3.10 or above.

Verify before relying

• Rate limiting behavior and handling strategies for the Todoist API
• Pagination details and limits for large result sets
• Retry logic and timeout configuration options

Package facts

Evidence: todoist_api_python-4.0.0-py3-none-any.whl

Keywords: api, python, rest, sync, todoist

Tags

More Python Modules packages