Todoist API

Todoist Api

When to Use This Skill

USE Todoist API when:

• Automating task creation from external systems
• Building integrations with other productivity tools
• Creating custom task dashboards or reports
• Implementing GTD workflows programmatically
• Syncing tasks with calendar applications
• Building CLI tools for task management
• Automating recurring task patterns
• Integrating with CI/CD for project tracking

DON'T USE Todoist API when:

• Need complex project management (use Jira, Asana)
• Require database-style queries (use Notion API)
• Need real-time collaboration on tasks (use Linear)
• Building for enterprise with SSO requirements
• Need Gantt charts or resource management

Prerequisites

API Authentication

# Get your API token from:
# https://todoist.com/app/settings/integrations/developer

# Set environment variable
export TODOIST_API_KEY="your-api-token-here"

# Verify authentication
curl -s -X GET "https://api.todoist.com/rest/v2/projects" \
    -H "Authorization: Bearer $TODOIST_API_KEY" | jq '.[0]'

Python SDK Installation

# Install official Python SDK
pip install todoist-api-python

# Or with uv
uv pip install todoist-api-python

# For sync API features
pip install todoist-api-python requests

Verify Setup

from todoist_api_python import TodoistAPI

api = TodoistAPI("your-api-token")

# Test connection
try:
    projects = api.get_projects()
    print(f"Connected! Found {len(projects)} projects")
except Exception as e:
    print(f"Connection failed: {e}")

Version History

Resources

• Todoist REST API Documentation
• Todoist Sync API Documentation
• Todoist Python SDK
• Filter Query Syntax
• Webhook Events Reference

This skill enables powerful task management automation through Todoist's comprehensive API, supporting projects, tasks, labels, filters, webhooks, and batch operations.

Sub-Skills

• 1. Projects Management
• 2. Tasks Management
• 3. Labels Management (+1)
• 5. Comments Management (+1)
• 7. Sync API
• 8. Webhooks
• Integration with Slack (+1)
• 1. Rate Limiting (+3)
• Common Issues

Sub-Skills

• Example 1: GTD Weekly Review Automation
• Overdue Tasks ({len(report['overdue'])})
• Upcoming This Week ({len(report['upcoming'])})
• Waiting For ({len(report['waiting_for'])})
• Example 2: Project Template Creator (+1)
• Summary
• Overdue Tasks