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

# Let AI Agents Manage Your Todoist Tasks

> Let agents create, complete, and organize Todoist tasks and projects. Connect with OAuth, and the gateway injects tokens so agents never handle them.

## Overview

Buckle connects AI agents to Todoist through Todoist's OAuth flow. Agents can create tasks, mark them complete, organize them into projects, and query your task list. The gateway injects OAuth credentials into requests to the Todoist API automatically.

This is useful for agents that need to track work items, create follow-up tasks after completing operations, or manage to-do lists on your behalf.

## What you will set up

* A Todoist connection through OAuth
* Automatic token injection on Todoist API requests
* Per-agent, per-tool access to tasks and projects

## Setup

**1. Open the app**

Open the Buckle dashboard and navigate to **Settings** > **Apps** > **Todoist**.

**2. Authorize**

Click **Connect Todoist**. You'll be redirected to Todoist to authorize Buckle. Review the permissions and click **Agree**.

![Buckle connect window for Todoist on Cloud, showing the Connect to Todoist button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/todoist/buckle-connect-todoist.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=d52c2e16fc304b5b8511deaf829883a3)

The Todoist connect window on Buckle Cloud.

## Self-hosted: use your own Todoist app

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** It's only for self-hosted Buckle without `TODOIST_CLIENT_ID` and `TODOIST_CLIENT_SECRET` set, or if you want your own company name on Todoist's consent screen.

> [accordion] 1. Create the Todoist app
>
> Open the [Todoist App Management console](https://developer.todoist.com/appconsole.html) and select **Create a new app**. Name it `Buckle`.
>
> ![Todoist Create App dialog with the app name Buckle and the Create App button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/todoist/01-provider-setup.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=25d7c4b2640c1bd5b7a413f63a9c65fd)
>
> Create the app in Todoist's App Management.

> [accordion] 2. Add the redirect URL
>
> In Buckle, open **Settings** > **Apps** > **Todoist** > **Custom credentials** and copy the **Redirect URI**. In Todoist, paste it into **OAuth redirect URL** and save. Buckle requests the `data:read_write` and `data:delete` scopes, so there's nothing else to tick.
>
> ![Buckle Custom credentials card for Todoist with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/todoist/buckle-custom-credentials-todoist.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=81be671133385810e2b8865d40813194)
>
> Copy the Redirect URI from Custom credentials in Buckle.
>
> ![Todoist app settings for Buckle showing the Client ID, a hidden Client secret, and https://buckle.example.com/v1/apps/todoist/callback under OAuth redirect URL.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/todoist/02-provider-redirect.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=adb8e1005c99c34ac4288827fc30b3ab)
>
> Your Todoist app's settings with the Buckle redirect URL.

> [accordion] 3. Connect with your app
>
> Copy the app's **Client ID** and **Client secret**. Paste both into **Settings** > **Apps** > **Todoist** > **Custom credentials**, select **Save credentials**, then **Connect** and click **Agree** in Todoist.

## What agents can do

* List all active tasks, optionally filtered by project, label, or due date
* Create new tasks with a title, description, due date, priority, and labels
* Complete (close) tasks
* Reopen completed tasks
* Update task details (title, description, due date, priority, labels)
* Delete tasks
* List, create, and manage projects
* List, create, and manage sections within projects
* Add and remove labels
* Read and add comments on tasks

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Todoist.

## FAQ

> [accordion] Does the agent see my Todoist token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can I stop an agent from deleting tasks?
>
> Yes. Block or require approval for delete tools when you [grant](/docs/guides/agent-access.md) the connection.

> [accordion] How do I reconnect Todoist?
>
> Open **Settings** > **Apps** > **Todoist** and connect again. Agents with access use the new connection automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.