todoist

Manage repository-scoped Todoist tasks via the Todoist API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/swat9013/dotfiles --skill todoist-swat9013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todoist
Source: https://github.com/swat9013/dotfiles/tree/main/.claude-global/skills/todoist
Command: npx skills add https://github.com/swat9013/dotfiles --skill todoist-swat9013

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires todoist-api-python>=3,<4, and includes scripts (resource) components.

What problem does it solve?

This Skill bridges a local Git repository and Todoist so you can manage project-scoped tasks without manually switching contexts, ensuring repository work items are tracked, prioritized, and updated in a consistent Todoist project namespace.

Core Features & Use Cases

  • Initializes a repository-specific Todoist subproject under projects/<repo> and ensures idempotent setup.
  • Lists and formats tasks by priority and due date, retrieves task details including subtasks, and supports add, update, complete, and delete operations.
  • Use cases: quickly view outstanding repo tasks, convert vague chores into actionable items, split large tasks into subtasks, and start or close work items directly from a Todoist-backed workflow.
  • Safety: write operations (init, add, update, close, delete) are intended to be performed only after user confirmation; listing and fetching are safe to run immediately.

Quick Start

Use the todoist skill to list and prioritize tasks for this repository by running the embedded script's list command and reviewing the output.

Frequently Asked Questions about todoist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage git repository tasks in Todoist without switching contexts?

Manage git repository tasks in Todoist by mapping the repository to a Todoist subproject under projects/<repo>, enabling initialization, listing, addition, update, completion, and deletion of scoped tasks programmatically.

How do I list and format Todoist tasks by priority and due date for a specific project?

List and format Todoist tasks by priority and due date by calling the embedded script's list command, which retrieves and formats repository-scoped tasks via the todoist-api-python client for immediate review.

Do I need a Todoist API token configured to manage repository task management via scripts?

Yes, you need a Todoist API token configured at ~/.config/todoist/config.json and the todoist-api-python client to interact with Todoist programmatically for repository task management.

Can I split large tasks into subtasks and convert vague chores into actionable items in Todoist?

Yes, you can split large tasks into subtasks and convert vague chores into actionable items by applying the Todoist API to refine task details and perform user-confirmed add and update operations for repository-scoped projects.

Are write operations like adding, updating, and deleting Todoist tasks safe to run immediately?

Write operations like adding, updating, completing, and deleting Todoist tasks are intended to be performed only after user confirmation, while listing and fetching tasks are safe to run immediately.