How do I install the Todoist API REST skill?

Run npx skillmds@latest add dvcrn/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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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?

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

Todoist API REST by dvcrn — Agent Skill

Name: Todoist API REST
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

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.## SetupEnsure `TODOIST_API_TOKEN` is set or use the token from `~/.openclaw/.secrets/todoist_token.json`.## Core Commands (REST v2)### List Active Tasks```bashcurl -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```bashcurl -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```bashcurl -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)```bashcurl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/api/v1/tasks | jq .results```### Create Task (v1)```bashcurl -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)```bashcurl -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```bashcurl -H "Authorization: Bearer $TODOIST_API_TOKEN" https://api.todoist.com/rest/v2/projects```### List Sections```bashcurl -H "Authorization: Bearer $TODOIST_API_TOKEN" "https://api.todoist.com/rest/v2/sections?project_id=<project_id>"```

Frequently asked questions

Todoist API REST