At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0.
- Connection: A user authorizes the connection in the provider’s consent screen.
- Scopes:
data:read_write. - Docs: https://developer.todoist.com/api/v1/
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.Setup
- Create a Todoist app: Go to the Todoist App Management console at https://developer.todoist.com/appconsole.html and create a new app.
- Configure the OAuth redirect: Set the OAuth redirect URL to your callback (e.g. https://your-app.example.com/api/auth/todoist/callback).
- Set environment variables: Copy the Client ID and Client Secret into your .env as TODOIST_CLIENT_ID and TODOIST_CLIENT_SECRET.
- Verify access: Connect your Todoist account and run the List Projects tool. A free Todoist account is sufficient for testing.
- Todoist scopes are comma-separated in the authorize URL (e.g. data:read_write). The data:read_write scope covers all tools in this connector.
- This connector uses the unified Todoist API v1 (api.todoist.com/api/v1); the older REST v2 API is deprecated.
Tools
| Tool | Access | Description |
|---|---|---|
| List Tasks | Read | List active tasks, optionally filtered by project |
| Get Task | Read | Get details of a specific task |
| Create Task | Write | Create a new task |
| Update Task | Write | Update an existing task |
| Complete Task | Write | Mark a task as complete |
| List Projects | Read | List the user’s projects |
Example prompts
- List my active Todoist tasks with their due dates and priorities.
- Create a new Todoist task with a description and due date.