noteist 0.3.1

Output a Markdown formatted report of completed tasks in Todoist.

Noteist

A script to generate a Markdown report of completed tasks in a Todoist project.

Features

• Lists completed tasks for a specified project and date range
• Outputs in Markdown format
• Supports sub-tasks and descriptions

Requirements

1. Get your Todoist API Token
   • Log in to your Todoist account.
   • Go to Settings > Integrations > Developer (tab).
   • Copy your API token from the "API token" section.
2. Install UV

Usage

Print help:

uvx noteist --help                                                               

Out completed tasks for the Todoist project Work with the default of two weeks:

uvx noteist --project "Work" --token <TOKEN>

Save the project "Work" and your token as the defaults:

uvx noteist --project "Work" --token <TOKEN> --save-project --save-token

Specify the time range:

uvx noteist --since 2025-07-01 --until 2025-07-15

Development

To run the script locally while in development.

1. Clone the repository.
2. Then run the script with: uv run -m noteist

Formatting Code

To format the codebase using ruff:

just format

License

MIT