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

# Todoist Integration: Task Management for Agents

> Create, complete, and organize tasks and projects in Todoist. API tokens are injected by the gateway. Agents never see them.

## Overview

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

## Setup

<Steps>
  <Step title="Go to Connections">
    Open the OneCLI dashboard and navigate to **Connections** > **Todoist**.
  </Step>

  <Step title="Authorize">
    Click **Connect Todoist**. You'll be redirected to Todoist to authorize OneCLI. Review the permissions and click **Agree**.
  </Step>
</Steps>

## 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) 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) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Todoist.