Skip to main content

​
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

1

Go to Connections

Open the OneCLI dashboard and navigate to Connections > Todoist.
2

Authorize

Click Connect Todoist. You’ll be redirected to Todoist to authorize OneCLI. Review the permissions and click Agree.

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