---
id: todoist-api-python
version: "4.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# todoist_api_python — Official Python SDK for the Todoist API.

License: permissive · Maintenance: active · Downloads: 182.8K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 182.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

todoist api client python, todoist sdk, task management api, todoist async client, todoist rest api wrapper, todoist python library, rest-api-client, task-management, async-support

[View on SkillFed](https://skillfed.io/packages/todoist-api-python) · [View on PyPI](https://pypi.org/project/todoist-api-python/)