pi-todoist-reader

Pi extension: read your Todoist bugs/tasks from the agent, and close the ones you have finished.

Packages

Package details

extension

Install pi-todoist-reader from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-todoist-reader

Package: pi-todoist-reader
Version: 0.1.0
Published: Sep 28, 2026
Downloads: 183/mo · 10/wk
Author: frachecco86
License: MIT
Types: extension
Size: 20.1 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-todoist-reader

A pi extension that gives the agent access to your Todoist bugs and tasks, so it can read them and close the ones you have finished.

What it provides

One tool, todoist_read:

action	what it does
`projects`	list your projects
`list`	open tasks, optionally scoped to a project
`filter`	run a Todoist filter query (e.g. `"#Backlog & @bug"`)
`get`	a single task by id, including its description
`close`	mark one or more tasks as done (`id` or `ids`)

Plus a convenience command: /bugs [project] [limit].

close is the only write action. The extension cannot create, edit or delete tasks — closing is reversible by hand in Todoist, and that is deliberate.

Install

pi install npm:pi-todoist-reader

Auth

The extension reads your personal Todoist API token from the TODOIST_TOKEN environment variable:

export TODOIST_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Add it to your shell profile (~/.bashrc, ~/.zshrc) so pi inherits it, then restart pi.

Get a token from Todoist → Settings → Integrations → Developer.

The token is read from the environment at call time and is never written to disk, logged, or sent anywhere except api.todoist.com.

Usage examples

Ask the agent things like:

"read the bugs in the Sboogle app project"
"close the bugs I just fixed"
"what's due today in my Backlog?"

License

MIT