How do I install the Todoist API REST skill?

Run npx skillmds add modbender/todoist-api-rest in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Todoist API REST safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Todoist API REST?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Todoist API REST free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Todoist API REST?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Todoist API REST by modbender — Agent Skill

Name: Todoist API REST
Rating: 4.2 (5 reviews)
Author: modbender

File contents

Todoist API (REST v2 & API v1)

This skill provides direct API access to Todoist. Use this when the CLI is unavailable or failing.

Setup

Ensure TODOIST_API_TOKEN is set or use the token from ~/.openclaw/.secrets/todoist_token.json.

Core Commands (REST v2)

List Active Tasks

curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/tasks | jq .

Note: If rest/v2 returns 410, use api/v1/tasks (see below).

Create Task

curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "New Task", "due_string": "today"}' \
     https://api.todoist.com/rest/v2/tasks

Close (Complete) Task

curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/tasks/<task_id>/close

Fallback / Legacy Commands (API v1)

Use these if REST v2 endpoints return 410 Gone.

List Tasks (v1)

curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/api/v1/tasks | jq .results

Create Task (v1)

curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "v1 Task", "project_id": "6g382hF2W96x2hvr"}' \
     https://api.todoist.com/api/v1/tasks

Completed Tasks (v1)

curl -H "Authorization: Bearer $TODOIST_API_TOKEN" \
     "https://api.todoist.com/api/v1/tasks/completed/by_completion_date?since=2026-03-01T00:00:00Z&until=2026-03-04T23:59:59Z" | jq .items

Projects & Sections

List Projects

curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/projects

List Sections

curl -H "Authorization: Bearer $TODOIST_API_TOKEN" "https://api.todoist.com/rest/v2/sections?project_id=<project_id>"

---name: todoist-api-restdescription: Direct Todoist API integration via curl/jq. Lightweight, reliable, and uses working v1/v2 endpoints.--- # Todoist API (REST v2 & API v1) This skill provides direct API access to Todoist. Use this when the CLI is unavailable or failing. ## Setup Ensure `TODOIST_API_TOKEN` is set or use the token from `~/.openclaw/.secrets/todoist_token.json`. ## Core Commands (REST v2) ### List Active Tasks ```bash curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/tasks | jq . ``` *Note: If rest/v2 returns 410, use `api/v1/tasks` (see below).* ### Create Task ```bash curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"content": "New Task", "due_string": "today"}' \ https://api.todoist.com/rest/v2/tasks ``` ### Close (Complete) Task ```bash curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/tasks/<task_id>/close ``` ## Fallback / Legacy Commands (API v1) Use these if REST v2 endpoints return `410 Gone`. ### List Tasks (v1) ```bash curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/api/v1/tasks | jq .results ``` ### Create Task (v1) ```bash curl -X POST -H "Authorization: Bearer $TODOIST_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"content": "v1 Task", "project_id": "6g382hF2W96x2hvr"}' \ https://api.todoist.com/api/v1/tasks ``` ### Completed Tasks (v1) ```bash curl -H "Authorization: Bearer $TODOIST_API_TOKEN" \ "https://api.todoist.com/api/v1/tasks/completed/by_completion_date?since=2026-03-01T00:00:00Z&until=2026-03-04T23:59:59Z" | jq .items ``` ## Projects & Sections ### List Projects ```bash curl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/projects ``` ### List Sections ```bash curl -H "Authorization: Bearer $TODOIST_API_TOKEN" "https://api.todoist.com/rest/v2/sections?project_id=<project_id>" ```

Frequently asked questions