npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@constablew/node-red-contrib-todoist-api

v2.1.1

Published

Todoist API v1 nodes for Node-RED (fork of @foxleigh81/node-red-contrib-todoist-api)

Readme

@constablew/node-red-contrib-todoist-api

Todoist API v1 for Node-RED

npm

⚠️ This is a maintained fork of @foxleigh81/node-red-contrib-todoist-api by Alex Foxleigh, which is no longer maintained. Version 2.x targets the Todoist API v1 (https://api.todoist.com/api/v1/). List endpoints (all tasks, all projects) are fetched page by page and returned as a flat array in msg.payload.data.

This is a node-red palette that allows you to interact with your Todoist account via the Todoist API.

Install

You can install via the node-red palette manager or via npm:

npm i --unsafe-perm @constablew/node-red-contrib-todoist-api

Usage

Configuration

To start using these nodes you need a token configuration node: drag any Todoist node from the palette into the flow editor, double-click it, click the pencil next to Select Token, and paste your Todoist API token. All Todoist nodes can share this one configuration.

To get your personal Todoist API token, open https://app.todoist.com/app/settings/integrations/developer in Todoist (Settings → Integrations → Developer).

Adding data

Each node reads its input from msg.payload (an object, e.g. { "id": "123" } or { "content": "Buy milk" }) and sends the Todoist response on its output as msg.payload.data. The fields every node understands are listed in docs/nodes.md. See the example below for a basic flow that creates a new task in your Todoist project.

Example flow

Import this into Node-RED (menu → Import). It has two injects: one creates a task in your Inbox, the other lists everything due today or overdue. Open the Todoist config node and paste your API token. IDs in Todoist API v1 are strings, e.g. "project_id": "6Jf8VQXxpwv56VQ7" (omit it to use the Inbox).

[
  {
    "id": "ex_inject_create",
    "type": "inject",
    "z": "ex_tab",
    "name": "Create task",
    "props": [
      {
        "p": "payload"
      }
    ],
    "repeat": "",
    "crontab": "",
    "once": false,
    "onceDelay": 0.1,
    "topic": "",
    "payload": "{\"content\":\"Buy milk\",\"priority\":4,\"due_string\":\"tomorrow\"}",
    "payloadType": "json",
    "x": 150,
    "y": 80,
    "wires": [
      [
        "ex_create"
      ]
    ]
  },
  {
    "id": "ex_create",
    "type": "todoist-task-create",
    "z": "ex_tab",
    "name": "",
    "token": "ex_token",
    "x": 370,
    "y": 80,
    "wires": [
      [
        "ex_debug"
      ]
    ]
  },
  {
    "id": "ex_inject_filter",
    "type": "inject",
    "z": "ex_tab",
    "name": "Due today",
    "props": [
      {
        "p": "payload"
      }
    ],
    "repeat": "",
    "crontab": "",
    "once": false,
    "onceDelay": 0.1,
    "topic": "",
    "payload": "{\"query\":\"today | overdue\"}",
    "payloadType": "json",
    "x": 150,
    "y": 140,
    "wires": [
      [
        "ex_filter"
      ]
    ]
  },
  {
    "id": "ex_filter",
    "type": "todoist-task-filter",
    "z": "ex_tab",
    "name": "",
    "token": "ex_token",
    "x": 370,
    "y": 140,
    "wires": [
      [
        "ex_debug"
      ]
    ]
  },
  {
    "id": "ex_debug",
    "type": "debug",
    "z": "ex_tab",
    "name": "Todoist response",
    "active": true,
    "tosidebar": true,
    "console": false,
    "tostatus": false,
    "complete": "payload",
    "targetType": "msg",
    "x": 600,
    "y": 110,
    "wires": []
  },
  {
    "id": "ex_token",
    "type": "add-todoist-api-token",
    "name": "Todoist"
  }
]

The payload is the same data as in the Todoist API v1 documentation. Every node and its fields are in docs/nodes.md.

Nodes available

All nodes are in the palette category Todoist. The complete reference with all payload fields, examples and outputs is in docs/nodes.md.

| Area | Nodes | | --- | --- | | Tasks | Get all tasks, Get tasks by filter, Get a task, Create a task, Quick add task, Update a task, Move a task, Complete a task, Reopen a task, Delete a task | | Projects | Get all projects, Get, Create, Update, Archive / Unarchive, Delete | | Sections | List all, Get, Create, Update, Delete | | Labels | List all, Get, Create, Update, Delete | | Comments | List, Create, Update, Delete | | Generic | Custom query for any other endpoint of the Todoist API v1 |

Good to know (details in docs/nodes.md):

  • Result data is in msg.payload.data, the HTTP status in msg.payload.status.
  • List nodes load all pages from the API and return one flat array.
  • On API errors msg.payload is the error object (msg.payload.response.status, msg.payload.response.data).
  • Nodes added in 2.1.0 check the token and required payload fields before sending a request.

Test flow

examples/todoist-test-flow.json is an importable flow (Node-RED menu → Import) with one inject per node and a shared debug output for manual testing. It also contains an auto test that creates a throw-away project ClaudeTest, runs all nodes against it and deletes it again. After importing, enter your Todoist API token in the "Todoist Token" config node and replace the placeholder IDs (PROJECT_ID, TASK_ID, ...) in the inject payloads for the manual tests.

License

GNU General Public License v3.0 – see LICENSE.

Originally created by Alex Foxleigh, maintained by ConstableW.

Support

Buy Me a Coffee – Maintainer:

Buy Me a Coffee – Maintainer

Support the original author:

ko-fi