todoist-api

Task management API integration for Todoist with projects, tasks, labels, filters, webhooks, and Python SDK usage

5 stars

byvamseeachanta

View on GitHub Installation ↓

Best use case

todoist-api is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Task management API integration for Todoist with projects, tasks, labels, filters, webhooks, and Python SDK usage

Teams using todoist-api should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/todoist-api/SKILL.md --create-dirs "https://raw.githubusercontent.com/vamseeachanta/workspace-hub/main/.agents/skills/business/productivity/todoist-api/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/todoist-api/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How todoist-api Compares

Feature / Agent	todoist-api	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Task management API integration for Todoist with projects, tasks, labels, filters, webhooks, and Python SDK usage

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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

```bash
# 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

```bash
# 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

```python
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

| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2025-01-17 | Initial release with comprehensive Todoist API coverage |

## Resources

- [Todoist REST API Documentation](https://developer.todoist.com/rest/v2/)
- [Todoist Sync API Documentation](https://developer.todoist.com/sync/v9/)
- [Todoist Python SDK](https://github.com/Doist/todoist-api-python)
- [Filter Query Syntax](https://todoist.com/help/articles/introduction-to-filters)
- [Webhook Events Reference](https://developer.todoist.com/sync/v9/#webhooks)

---

*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](1-projects-management/SKILL.md)
- [2. Tasks Management](2-tasks-management/SKILL.md)
- [3. Labels Management (+1)](3-labels-management/SKILL.md)
- [5. Comments Management (+1)](5-comments-management/SKILL.md)
- [7. Sync API](7-sync-api/SKILL.md)
- [8. Webhooks](8-webhooks/SKILL.md)
- [Integration with Slack (+1)](integration-with-slack/SKILL.md)
- [1. Rate Limiting (+3)](1-rate-limiting/SKILL.md)
- [Common Issues](common-issues/SKILL.md)

## Sub-Skills

- [Example 1: GTD Weekly Review Automation](example-1-gtd-weekly-review-automation/SKILL.md)
- [Overdue Tasks ({len(report['overdue'])})](overdue-tasks-lenreportoverdue/SKILL.md)
- [Upcoming This Week ({len(report['upcoming'])})](upcoming-this-week-lenreportupcoming/SKILL.md)
- [Waiting For ({len(report['waiting_for'])})](waiting-for-lenreportwaitingfor/SKILL.md)
- [Example 2: Project Template Creator (+1)](example-2-project-template-creator/SKILL.md)
- [Summary](summary/SKILL.md)
- [Overdue Tasks](overdue-tasks/SKILL.md)