šŸ¦žOpenClaw Guide
← All Integrations
āœ…

Todoist

Easyā±ļø 10 minutes

AI task management via Todoist

The Fastest Way: HeraClaw Cloud ⚔

Skip the API token hunting and configuration files. HeraClaw Cloud comes with Todoist integration pre-configured and ready to connect in 60 seconds.

Why HeraClaw Cloud for Todoist?

āœ… Ready in 60 seconds - No API token copying, no config file editing āœ… OAuth flow - Just click "Connect Todoist" and authorize āœ… Smart project mapping - We automatically discover your projects āœ… Natural language - Create tasks exactly how you think āœ… Professional support - If Todoist API breaks, we fix it āœ… Zero maintenance - We handle API updates automatically

How it works:

  1. Sign up at cloud.getopenclaw.ai (takes 60 seconds)
  2. Go to Integrations → Todoist
  3. Click 'Connect Todoist'
  4. Authorize in Todoist's OAuth screen
  5. Done! Create and manage tasks from anywhere

Get Started: Start with HeraClaw Cloud →


Complete Guide to OpenClaw + Todoist

Todoist is the task management system trusted by 30+ million users worldwide. Whether you're a GTD practitioner, a busy professional juggling projects, or a student managing assignments, Todoist is your external brain for tracking what needs to be done.

OpenClaw's Todoist integration transforms task management from "open app, find project, click add task, fill form" into simply saying "remind me to call Mom tomorrow at 2pm." Natural language task capture, intelligent project assignment, and automatic due date parsing - all available from any messaging app you already use.

Why Use Todoist with OpenClaw?

Task management apps have a fatal flaw: friction. The moment between thinking "I need to do X" and actually recording it is where tasks die. You're in a meeting, someone assigns you something, and by the time you:

  1. Open Todoist app
  2. Wait for it to sync
  3. Navigate to the right project
  4. Click "Add task"
  5. Type the task
  6. Set due date (calendar picker)
  7. Assign labels/priority
  8. Hit save

...you've forgotten the context or gotten distracted.

With OpenClaw, it's instant:

bash
You: Add task review contract for Acme Corp, high priority, due Friday, tag legalAssistant: āœ“ Created task "Review contract for Acme Corp"   - Project: Work   - Priority: High (P1)   - Due: Friday, April 12, 5:00 PM   - Labels: legal   - Link: https://todoist.com/showTask?id=...

Total time: 5 seconds. No app switching. No context loss.

Core Capabilities

Natural Language Task Creation

OpenClaw understands how you naturally describe tasks:

Simple tasks:

bash
"Add task: Buy milk"→ Created in Inbox"Remind me to call John"→ Created with @phone label (if you use it)"I need to review the budget proposal"→ Created: "Review budget proposal"

Tasks with due dates:

bash
"Add buy groceries tomorrow"→ Due: Tomorrow, 5:00 PM"Remind me to submit the report by Friday"→ Due: Friday, 5:00 PM"Call dentist next Monday at 9am"→ Due: Monday, April 15, 9:00 AM (time-specific)"Finish project proposal in 3 days"→ Due: 3 days from now

Tasks with projects:

bash
"Add to Personal: Schedule dentist appointment"→ Created in "Personal" project"Work task: Review Q2 metrics"→ Created in "Work" project"Add to Home Improvement: Fix leaky faucet"→ Created in "Home Improvement" project

Tasks with priority:

bash
"Urgent: Call accountant by Thursday"→ Priority: P1 (highest), Due: Thursday"High priority task: Submit tax documents"→ Priority: P1"Low priority: Organize garage"→ Priority: P3

Tasks with labels:

bash
"Add read article about AI, tag learning"→ Label: @learning"Call lawyer about contract, tags legal and urgent"→ Labels: @legal, @urgent

Recurring tasks:

bash
"Take vitamins every morning"→ Recurring: Every day at 9:00 AM"Weekly team sync every Monday at 10am"→ Recurring: Every Monday at 10:00 AM"Pay rent on the 1st of every month"→ Recurring: Monthly on day 1"Water plants every 3 days"→ Recurring: Every 3 days

Complex tasks (everything at once):

bash
"Add to Work: Finish Q2 presentation for board meeting, high priority, due next Friday, tag presentations and urgent"→ Created:   - Task: "Finish Q2 presentation for board meeting"   - Project: Work   - Priority: P1 (high)   - Due: Friday, April 19, 5:00 PM   - Labels: @presentations, @urgent

The beauty: no form fields, no date pickers, no dropdowns. Just say it.

Task Management

Query tasks:

bash
"What's on my plate today?"→ 4 tasks due today:   1. āœ… Review budget (done)   2. [ ] Call dentist (2:00 PM)   3. [ ] Submit expense report   4. [ ] Meeting prep: board review (4:30 PM)"What's due this week?"→ 12 tasks due this week (Monday-Sunday):   Monday: 3 tasks   Tuesday: 2 tasks   Wednesday: 4 tasks   Thursday: 1 task   Friday: 2 tasks"Show me high priority tasks"→ 5 high-priority tasks:   1. Submit tax documents (due: April 15)   2. Review contract for Acme (due: Friday)   3. Call investor about funding (due: today)   ..."What's overdue?"→ 2 overdue tasks:   1. Write blog post (3 days overdue)   2. Schedule dentist (1 week overdue)

Complete tasks:

bash
"Mark 'Write blog post' as done"→ āœ“ Task "Write blog post" marked complete   Karma +5 points"Complete all tasks tagged 'urgent'"→ Completed 3 tasks:   - Submit tax forms āœ“   - Call lawyer āœ“     - Review contract āœ“"I finished the budget review"→ āœ“ "Review budget" marked complete

Update tasks:

bash
"Move 'Call dentist' to tomorrow"→ Task rescheduled: Today → Tomorrow, 5:00 PM"Change priority of 'Submit taxes' to urgent"→ Task "Submit tax documents" priority: P2 → P1"Move 'Buy groceries' to Personal project"→ Task moved: Inbox → Personal"Add label 'waiting' to the contract review task"→ Added label @waiting to "Review contract for Acme"

Delete tasks:

bash
"Delete the 'Organize garage' task"→ Deleted task "Organize garage""Remove all completed tasks from last month"→ Archived 47 completed tasks from March

Project Management

Query projects:

bash
"What projects do I have?"→ 8 active projects:   - Inbox (23 tasks)   - Work (47 tasks)   - Personal (18 tasks)   - Home Improvement (5 tasks)   - Learning (12 tasks)   - Health (8 tasks)   - Finance (6 tasks)   - Shopping (9 tasks)"Show all tasks in the Website Redesign project"→ Website Redesign (8 tasks):   āœ“ Design mockups (completed)   [ ] Build homepage (in progress)   [ ] Write copy (due: Friday)   [ ] QA testing (due: April 18)   ...

Create projects:

bash
"Create a project called Q2 Planning"→ āœ“ Created project "Q2 Planning"   Link: https://todoist.com/app/project/..."New project: Summer Vacation with color blue"→ āœ“ Created project "Summer Vacation" (blue color)

Organize projects:

bash
"Archive the Q4 project"→ āœ“ Project "Q4 Planning" archived (47 tasks archived with it)"Move all tasks from Inbox to Work"→ Moved 12 tasks: Inbox → Work

Batch Operations

Create multiple tasks at once:

bash
You: Add these tasks for today:- Review the new pricing page- Respond to client emails- Update the roadmap doc- Call vendor about invoiceAssistant: āœ“ Created 4 tasks (all due today):   1. Review the new pricing page   2. Respond to client emails   3. Update the roadmap doc   4. Call vendor about invoiceAll added to Inbox. Want to assign to specific projects?

Meeting follow-ups:

bash
You: From today's meeting:- John to review the proposal by Wednesday- Sarah to send updated design by Thursday- I need to write the brief todayAssistant: āœ“ Created 3 tasks:   Task: "John: review the proposal"   - Due: Wednesday   - Note: "From meeting on April 9"      Task: "Sarah: send updated design"   - Due: Thursday   - Note: "From meeting on April 9"      Task: "Write the brief"   - Due: Today   - Project: WorkWant me to tag these with @meeting-followup?

Inbox zero:

bash
"Review my inbox and organize tasks"→ Analyzed 23 Inbox tasks:Suggested organization:- 8 tasks → Work (work-related keywords)- 5 tasks → Personal (personal errands)- 3 tasks → Home (home maintenance)- 7 tasks → Keep in Inbox (unclear project)Apply these moves?

Real-World Use Cases

1. Inbox Capture - The GTD Workflow

Scenario: You follow Getting Things Done (GTD) methodology. Quick capture is critical.

Traditional approach:

  1. Pull out phone
  2. Unlock
  3. Find Todoist app
  4. Wait for sync
  5. Click "+" button
  6. Type task
  7. Hit save
  8. Lock phone

Total: 15-20 seconds (if fast)

OpenClaw approach:

bash
[You're in a meeting, someone mentions something]You: [Quick message to assistant via Telegram]"Follow up with Mike about Q2 pricing"Assistant: [Instant vibration]āœ“ Added to Inbox[Back to meeting, 3 seconds elapsed]

Later, during daily review:

bash
You: Review inboxAssistant: 8 items in Inbox:1. Follow up with Mike about Q2 pricing   Suggested: Work project, tag @sales, due this week   2. Buy birthday gift for Sarah   Suggested: Personal, due before April 18   3. Research best practices for API rate limiting   Suggested: Learning, tag @technical-reading   ...Want me to apply suggestions and clear inbox?You: Yes, apply and organizeAssistant: āœ“ Inbox processed:   - 5 → Work   - 2 → Personal   - 1 → Learning   Inbox clear.

Impact:

  • Capture time: 3 seconds vs 15-20 seconds
  • Zero friction = actually capture everything
  • Intelligent organization suggestions
  • GTD weekly review is faster

2. Delegation and Team Coordination

Scenario: You manage a team. Tasks get assigned in Slack channels and meetings. Tracking who owns what is chaos.

OpenClaw solution:

bash
[In Slack channel #product]Teammate: "Can someone review the new onboarding flow by Friday?"You: @OpenClaw Add task for Sarah: Review new onboarding flow, due Friday, tag product-reviewAssistant: āœ“ Created in Work project:   "Sarah: Review new onboarding flow"   Due: Friday, April 12   Label: @product-review      Also sent reminder to Sarah in DM.[Later, check status]You: Show me all tasks assigned to SarahAssistant: Sarah's tasks (7 total):      Due this week:   - Review onboarding flow (Friday)   - Update API docs (Thursday)      Due next week:   - Q2 planning prep (Monday)   - Hire design contractor (Wednesday)   ...You: What's Sarah's workload look like?Assistant: Sarah's workload:      This week: 4 tasks (2 high-priority)   Next week: 3 tasks      Capacity: Moderate (tracking toward ~85% this week)      Recommendation: Friday deadline for onboarding review may be tight given 2 high-priority items due before it. Consider pushing to Monday?

Impact:

  • Task assignment happens in-flow (Slack/Telegram)
  • Visibility into team capacity
  • No separate project management tool needed
  • Automatic delegation tracking

3. Daily Planning - Morning Routine

Scenario: You want to start each day with a clear plan of what needs to be done.

OpenClaw morning routine:

bash
You: Good morning, what's on tap today?Assistant: Good morning! Your Friday, April 9:šŸ“… Calendar:- 10:00 AM: Team standup (30 min)- 2:00 PM: Client call with Acme Corp (1 hour)- 4:00 PM: 1:1 with Sarah (30 min)āœ… Tasks due today (6 items):High priority:1. Submit tax documents (P1, overdue by 1 day āš ļø)2. Review contract for Acme (P1, due 5:00 PM)Medium priority:3. Write blog post about API design (P2)4. Call dentist to schedule appointment (P2)Low priority:5. Read article about TypeScript 5.0 (P3)6. Update LinkedIn profile (P3)ā° Time available:- Morning: 2 hours before standup- Midday: 90 minutes between meetings- Afternoon: 30 minutes after 1:1Recommended order:1. Submit taxes (30 min, urgent)2. Review Acme contract (1 hour, needed before 2 PM call)3. Blog post (90 min, use midday block)4. Call dentist (10 min, use afternoon)5. Defer reading to evening/weekend6. Defer LinkedIn to next weekStart with taxes?You: Yes, let's do it. Set a 30-minute timer.Assistant: āœ“ Timer started (30 minutes)āœ“ Do Not Disturb enabledāœ“ Task "Submit tax documents" marked as in-progressI'll alert you at 9:30 AM. Focus mode activated.

Impact:

  • Clear daily plan in under 1 minute
  • Intelligent prioritization based on calendar
  • Time blocking recommendations
  • Focus mode support

4. Project Milestones - Progress Tracking

Scenario: You're managing a project with multiple milestones. You need visibility into progress.

OpenClaw tracking:

bash
You: Status update on the Website Redesign projectAssistant: Website Redesign Project Status:šŸ“Š Overall: 67% complete (8 of 12 tasks done)āœ… Completed milestones:- Discovery & wireframes āœ“- Design mockups āœ“- Stakeholder approval āœ“- Homepage development āœ“šŸ”„ In Progress:- Product page development (50% est.)- Content writing (30% est.)ā³ Not Started:- QA testing (due: April 18)- Launch (due: April 22)āš ļø At risk:- Content writing is 30% but due in 3 days (might miss deadline)Recommendation: Check with content team on status. Consider extending deadline or reducing scope.Want a detailed breakdown or next actions?You: What are the blockers?Assistant: Current blockers on Website Redesign:1. Content writing (due April 12)   - Assigned to: Sarah   - Status: 30% complete   - Blocker: Waiting on final brand guidelines from Marketing   - Impact: Delays product page launch   - Recommendation: Follow up with Marketing today2. QA testing (due April 18)   - Assigned to: Mike   - Status: Not started (waiting on dev completion)   - Blocker: Product page dev must finish first   - Impact: No blocker yet, but timeline is tight   - Recommendation: Pre-brief Mike on test planNo other blockers. 67% complete is on track for April 22 launch if content unblocks this week.Create follow-up tasks?

Impact:

  • Real-time project visibility
  • Blocker identification
  • Proactive risk management
  • Automated progress tracking

5. Habit Building - Recurring Task Mastery

Scenario: You want to build habits (exercise, reading, meditation) but need consistent reminders.

OpenClaw habit tracking:

bash
You: Set up my daily habits:- Meditate every morning at 7am- Exercise 3 times per week (Mon, Wed, Fri at 6pm)- Read for 30 minutes every evening at 9pm- Take vitamins every morning at 8amAssistant: āœ“ Created 4 recurring habits:1. "Meditate" - Every day at 7:00 AM2. "Exercise" - Every Mon, Wed, Fri at 6:00 PM3. "Read for 30 minutes" - Every day at 9:00 PM4. "Take vitamins" - Every day at 8:00 AMAll added to your "Health" project.Want me to send push notifications as reminders?You: Yes, remind meAssistant: āœ“ Notifications enabledYou'll get reminders:- 7:00 AM: Meditate- 8:00 AM: Take vitamins- 6:00 PM (M/W/F): Exercise- 9:00 PM: ReadI'll also track your completion streak. Good luck![A week later]You: How am I doing with habits?Assistant: Habit tracking (last 7 days):🧘 Meditate:- Completed: 6 of 7 days (86%)- Current streak: 3 days- Longest streak: 4 days- Missed: Yesterday (Sunday)šŸ’Ŗ Exercise:- Completed: 2 of 3 sessions (67%)- Completed: Mon āœ“, Wed āœ“, Fri āœ—- Note: Friday marked "skipped" - reason given: travelšŸ“š Read:- Completed: 5 of 7 days (71%)- Current streak: 2 days  - Average time: 28 minutes (close to 30 min goal)šŸ’Š Vitamins:- Completed: 7 of 7 days (100%) šŸ”„- Perfect week! Streak: 14 daysOverall: Strong week! Vitamins and meditation are going great. Consider rescheduling Friday exercise to avoid travel conflicts.

Impact:

  • Consistent reminders = habit formation
  • Streak tracking for motivation
  • Completion analytics
  • Adaptive scheduling

6. Email-to-Task Conversion

Scenario: Your inbox is full of emails that require action. Converting them to tasks manually is tedious.

OpenClaw email integration:

bash
You: Check my Gmail for emails that need action and create tasksAssistant: Scanning Gmail for action items...Found 8 emails requiring action:1. From: Mike (Acme Corp)   Subject: "Q2 pricing question"   Action: Respond with pricing options   → Created task: "Respond to Mike about Q2 pricing" (due: today, @email)2. From: Legal Department   Subject: "Contract signature needed"   Action: Review and sign contract   → Created task: "Review and sign vendor contract" (due: by EOD Friday, @legal, high priority)3. From: Sarah   Subject: "Can you review the deck?"   Action: Review attached presentation   → Created task: "Review Sarah's presentation deck" (due: before Monday meeting, @review)4. From: Accountant   Subject: "Tax document reminder"   Action: Submit missing W-2   → Created task: "Submit W-2 to accountant" (due: April 15, @taxes, urgent)...Created 8 tasks from emails. All linked to original emails for reference.Want me to archive these emails now that tasks are created?

Impact:

  • Email → Task conversion in seconds
  • Inbox zero workflow
  • Links to original emails preserved
  • Reduces email anxiety

Cross-Integration Workflows

Todoist becomes even more powerful when combined with other OpenClaw integrations:

Gmail + Todoist:

bash
"Create a task from the latest email from John"→ Reads email, extracts action item, creates task with link

Google Calendar + Todoist:

bash
"Add my calendar events for tomorrow as tasks"→ Creates prep tasks for each meeting

Notion + Todoist:

bash
"Add all incomplete tasks from my Notion project database to Todoist"→ Syncs Notion project tracker with Todoist

Slack + Todoist:

bash
[In Slack] @OpenClaw add task: Follow up on budget approval→ Creates task, confirms in Slack

Setup Option 1: HeraClaw Cloud (Recommended)

Time required: 60 seconds Technical skill: None Cost: Included in HeraClaw Cloud

Steps:

  1. Sign up for HeraClaw Cloud

    • Visit cloud.getopenclaw.ai
    • Takes 60 seconds
  2. Go to Integrations

    • Dashboard → Integrations → Todoist
    • Click "Connect Todoist"
  3. Authorize

    • Todoist OAuth screen appears
    • Click "Agree" to grant access
  4. Done!

    • Test: "What tasks are due today?"

What You Get:

  • OAuth integration (no API token needed)
  • Automatic project discovery
  • Natural language task creation
  • Real-time sync
  • Professional support

Get Started: Start with HeraClaw Cloud →


Setup Option 2: Self-Hosted (Advanced)

Time required: 5 minutes Technical skill: Basic (easy compared to other integrations)

Step-by-Step

Step 1: Get Your Todoist API Token

  1. Open Todoist (web or app)
  2. Go to Settings → Integrations → Developer
  3. Scroll to "API token"
  4. Copy the token (long string)

Step 2: Configure OpenClaw

Edit ~/.openclaw/config.yaml:

yaml
integrations:  todoist:    enabled: true    apiToken: "YOUR_TODOIST_API_TOKEN_HERE"        # Optional: Default project for quick capture    defaultProject: "Inbox"        # Optional: Default priority (1=normal, 2=high, 3=very high, 4=urgent)    defaultPriority: 1        # Optional: Labels to auto-assign based on keywords    autoLabels:      email: ["respond", "reply", "send email"]      phone: ["call", "phone"]      urgent: ["urgent", "asap", "immediately"]

Step 3: Test

bash
openclaw chat "What's on my Todoist today?"

Should list your tasks.

Step 4: Advanced Configuration (Optional)

yaml
integrations:  todoist:    # Map friendly names to project IDs    projectAliases:      work: "Work"      personal: "Personal"      home: "Home Improvement"        # Sync settings    sync:      interval: 300  # seconds (5 min)      realtime: true  # use Todoist sync API for instant updates        # Natural language improvements    nlp:      detectPriority: true  # "urgent" → P1      detectDates: true     # "tomorrow" → actual date      detectProjects: true  # "work task" → Work project

Troubleshooting

Tasks not appearing?

  • Verify API token is correct
  • Check token permissions (should have read + write)
  • Run: openclaw test integration todoist

"Project not found" errors?

  • Project names are case-sensitive
  • Use exact name from Todoist
  • Check projectAliases config

Sync delays?

  • Set realtime: true in config
  • Or lower sync.interval to 60 seconds

Comparison: HeraClaw Cloud vs Self-Hosted

FeatureHeraClaw CloudSelf-Hosted
Setup time60 seconds5 minutes
API token managementNot needed (OAuth)You manage
Project discoveryAutomaticManual config
Sync speedReal-timeConfigurable
SupportProfessionalCommunity
CostSubscriptionFree

FAQ

Q: Do I need Todoist Premium? A: No, works with free accounts. Premium adds features like reminders and filters.

Q: Can it handle recurring tasks? A: Yes. Say "Add take vitamins every morning" and it creates a recurring task.

Q: Does it sync in real-time? A: Yes. Tasks added through your assistant appear in Todoist immediately.

Q: Can it work with shared projects? A: Yes, if you have access to a shared project, your assistant can add tasks to it.

Q: What about subtasks? A: Supported. "Add subtask to 'Website Redesign': Design homepage"

Q: Can I create tasks from other apps? A: Yes! Integrates with Gmail (email → task), Slack (message → task), etc.

Q: Is there a limit on tasks? A: Free Todoist: 300 active projects, 5 projects. Premium: Unlimited.

Q: Can it use Todoist filters? A: Yes. "Show me tasks with #urgent label due this week"


Get Started: Start with HeraClaw Cloud →

Last updated: April 9, 2026

Features

Natural language tasks

Create tasks with full details using plain conversational language

Project management

Create and organize projects, assign labels, set priorities

Recurring tasks

Set up recurring tasks with natural language recurrence rules

Batch creation

Create multiple tasks at once from meeting notes or lists

Task updates

Complete, move, reschedule, and delete tasks by description

Cross-tool automation

Create tasks from emails, GitHub issues, or calendar events

Use Cases

→

Meeting follow-ups

Create all action items from meeting notes in one message

→

Inbox capture

Add tasks from Telegram, Slack, Discord without switching apps

→

Delegation tracking

Create and assign tasks with due dates to track team commitments

→

Daily planning

Review today's tasks and reorganize priorities each morning

Setup Guide

Requirements

  • āœ“Todoist account (free or premium)
  • āœ“Todoist API token
  • āœ“Optional: Todoist skill installed
1

Get your API token

In Todoist settings, go to Integrations > Developer and copy your API token.

2

Configure the integration

Add the token to your OpenClaw configuration under integrations.todoist.apiToken.

3

Test it

Ask your assistant 'What's on my Todoist today?' to verify connection.

Limitations

  • āš ļøSome advanced features (filters, labels) may require premium
  • āš ļøBulk operations may hit API rate limits

Frequently Asked Questions

Do I need Todoist Premium?

No, the integration works with free accounts. Premium adds features like reminders and filters.

Can it handle recurring tasks?

Yes. Say 'Add take vitamins every morning' and it creates a recurring task.

Does it sync in real-time?

Tasks added through your assistant appear in Todoist immediately. Changes in Todoist are reflected when you query.

Can it work with shared projects?

Yes, if you have access to a shared project, your assistant can add tasks to it.

šŸ”„ Your AI should run your business, not just answer questions.

We'll show you how.Free to join.

Join Vibe Combinator →

šŸ™ Your AI should run your business.

Weekly live builds + template vault. We'll show you how to make AI actually work.Free to join.

Join Vibe Combinator →