noteist 0.4.0

Output a Markdown formatted report of completed tasks in Todoist.

Noteist

Print out a report of completed tasks in a Todoist project in Markdown.

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

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

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

Save the project "Work" as the default:

uvx noteist config set project Work

Save the token "example-token" as the default:

uvx noteist config set token example-token

List saved defaults:

uvx noteist config list

Unset a saved default:

uvx noteist config unset project

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