| name | todoist-api |
| version | 1.0.0 |
| description | Task management API integration for Todoist with projects, tasks, labels, filters, webhooks, and Python SDK usage |
| author | workspace-hub |
| category | business |
| type | skill |
| capabilities | ["task_management","project_organization","label_filtering","natural_language_dates","recurring_tasks","webhook_integration","sync_api","batch_operations"] |
| tools | ["todoist-api","todoist-python","curl","jq"] |
| tags | ["todoist","tasks","api","productivity","gtd","webhooks","automation","project-management"] |
| platforms | ["rest-api","python","web","mobile"] |
| related_skills | ["api-integration","obsidian","notion-api"] |
| requires | [] |
| scripts_exempt | true |
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
export TODOIST_API_KEY="your-api-token-here"
curl -s -X GET "https://api.todoist.com/rest/v2/projects" \
-H "Authorization: Bearer $TODOIST_API_KEY" | jq '.[0]'
Python SDK Installation
pip install todoist-api-python
uv pip install todoist-api-python
pip install todoist-api-python requests
Verify Setup
from todoist_api_python import TodoistAPI
api = TodoistAPI("your-api-token")
try:
projects = api.get_projects()
print(f"Connected! Found {len(projects)} projects")
except Exception as e:
()