> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Todoist

> Manage tasks and projects in Todoist

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **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/](https://developer.todoist.com/api/v1/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                | Required | Description                                                                        |
| ----------------------- | -------- | ---------------------------------------------------------------------------------- |
| `TODOIST_CLIENT_ID`     | Yes      | Todoist OAuth Client ID [Docs](https://developer.todoist.com/appconsole.html).     |
| `TODOIST_CLIENT_SECRET` | Yes      | Todoist OAuth Client Secret [Docs](https://developer.todoist.com/appconsole.html). |

## Setup

1. **Create a Todoist app**: Go to the Todoist App Management console at [https://developer.todoist.com/appconsole.html](https://developer.todoist.com/appconsole.html) and create a new app.
2. **Configure the OAuth redirect**: Set the OAuth redirect URL to your callback (e.g. [https://your-app.example.com/api/auth/todoist/callback](https://your-app.example.com/api/auth/todoist/callback)).
3. **Set environment variables**: Copy the Client ID and Client Secret into your .env as TODOIST\_CLIENT\_ID and TODOIST\_CLIENT\_SECRET.
4. **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.

Provider API reference: [https://developer.todoist.com/api/v1/](https://developer.todoist.com/api/v1/)

## 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.