Todoist Integration

WARNING

The Todoist integration is currently in beta and may have limited functionality or unexpected behavior.

Iris integrates with Todoist to help you manage tasks through natural conversation. Create tasks, check your to-do list, mark items complete, and organize your work.

Features

• View Tasks: See today's tasks in context
• Create Tasks: Add tasks with natural language due dates
• Update Tasks: Modify task details and priorities
• Complete Tasks: Mark tasks as done
• Reopen Tasks: Restore completed tasks
• Delete Tasks: Remove tasks
• Project Support: Organize across projects

Setup

1. Create Todoist App

1. Go to Todoist App Console
2. Create a new app
3. Note your Client ID and Client Secret

2. Configure Environment

Add to .env:

TODOIST_CLIENT_ID=your-client-id
TODOIST_CLIENT_SECRET=your-client-secret

3. Connect Your Account

1. Open Iris and go to Settings
2. Find the Todoist integration
3. Click Connect and authorize access

Context Injection

When connected, Iris automatically sees your current tasks:

You: "What should I focus on today?"

Iris: "You have 5 tasks for today: Review PR #234 (due 10am), Write API docs, Call dentist, Buy groceries, Send weekly report. The PR is due soon - want to start there?"

Available Tools

Tool	Purpose
list_todoist_tasks	Fetch tasks (1-30 days ahead)
create_todoist_task	Create with content, due date, priority
update_todoist_task	Modify existing tasks
complete_todoist_task	Mark as done
reopen_todoist_task	Restore completed tasks
delete_todoist_task	Remove tasks

Example Conversations

You: "What's on my list for today?"

Iris: "You have 3 tasks due today: Review PR #234 (high priority), Send weekly report, Call dentist. Plus 2 overdue from yesterday."

You: "Remind me to buy Mom a birthday gift next week"

Iris: "Done! Added 'Buy birthday gift for Mom' due next Monday."

You: "I finished the PR review"

Iris: "Marked 'Review PR #234' as complete. 2 remaining tasks for today."

Configuration

Setting	Default	Description
todoist.cache_ttl	15	Cache duration (minutes)

Troubleshooting

Tasks not appearing: Check connection status in Settings, verify tasks have due dates.

Connection errors: Disconnect and reconnect in Settings.

Can't create tasks: Ensure your Todoist account is active and properly connected.