Todoist Integration
Connect Todoist to aura for seamless task management
Todoist Integration
Integrate your Todoist account with aura to supercharge your task management. Keep all your tasks in sync and manage them without ever leaving the aura interface.
What You Can Do
- Universal Task Management: Search, create, read, and update your Todoist tasks directly from aura
- Stay Organized: Keep your projects and tasks aligned with information from your other connected apps
- Effortless Sync: Ensure your to-do list is always up-to-date across both platforms
- Natural Language: Use conversational commands to manage your tasks
- Cross-Platform Integration: Connect tasks with emails, calendar events, and project management tools
Prerequisites
Before connecting Todoist to aura, you'll need:
- Todoist Account: An active Todoist account (free or premium)
- API Token: Your personal Todoist API token
- Permissions: Access to your Todoist projects and tasks
Connection Setup
Step 1: Get Your Todoist API Token
- Go to Todoist Settings
- Click on the "Integrations" tab
- Scroll down to find the "Developer" section
- Your API token will be displayed there
- Click to copy your API token
- Keep this token secure - it provides full access to your Todoist account
Step 2: Connect in aura
- Navigate to the Integrations page in aura
- Find "Todoist" and click "Connect & Configure"
- You'll see two tabs: "Info" and "Settings"
- Click on the "Settings" tab
- Paste your API token in the "API Token" field
- Click "Connect Todoist"
- Wait for the connection to be established
- Return to your dashboard to verify the status shows "Connected"
Understanding Connection Status
✅ Connected
Your Todoist integration is working properly. You can:
- Search and view all your tasks
- Create new tasks and projects
- Update existing tasks
- Complete and manage tasks
- Access all your Todoist data
⚠️ Not Connected
The integration hasn't been set up yet. Follow the connection setup steps above.
⚠️ Token Invalid
Your API token is no longer valid or has been revoked:
- Go to Todoist Settings
- Navigate to the "Developer" section
- Copy your API token (it may have been regenerated)
- Update it in aura's Todoist integration settings
- Click "Update Todoist"
Using the Todoist Integration
Searching Tasks
Use natural language to find tasks:
Examples:
- "Show me my tasks due today"
- "Find all high-priority tasks"
- "What tasks are in my Work project?"
- "Show me overdue tasks"
- "Find tasks with label 'urgent'"
Creating Tasks
Create new tasks through aura's chat interface:
Examples:
- "Create a task: Review Q4 budget report"
- "Add task to Work project: Schedule team meeting"
- "Create high-priority task: Fix login bug, due tomorrow"
- "Add task with label urgent: Call client about proposal"
aura will:
- Understand your intent
- Create the task in Todoist
- Set appropriate fields (project, priority, due date, labels)
- Confirm the creation
Updating Tasks
Modify existing tasks with natural language:
Examples:
- "Mark task 'Review budget' as complete"
- "Change due date of 'Team meeting' to Friday"
- "Update priority of 'Fix bug' to high"
- "Add label 'urgent' to task 'Client call'"
Viewing Task Details
Get detailed information about specific tasks:
Examples:
- "Show me details for task 'Review budget'"
- "What's the due date for 'Team meeting'?"
- "Which project is 'Fix bug' in?"
- "Show me all tasks in the Marketing project"
Managing Projects
Work with your Todoist projects:
Examples:
- "List all my projects"
- "Show me tasks in the Work project"
- "Create a new project called 'Q1 Planning'"
- "How many tasks are in my Personal project?"
Updating Your Integration
When to Update
Update your Todoist integration when:
- Your API token is regenerated
- The integration status shows "Token Invalid"
- You need to reconnect after disconnecting
- You're experiencing sync issues
How to Update
- Navigate to the Todoist integration page in aura
- Click the "Settings" tab
- Get your current API token from Todoist:
- Go to Todoist Settings
- Copy your API token from the Developer section
- Paste the token in aura
- Click "Update Todoist"
- Verify the status returns to "Connected"
Disconnecting the Integration
To remove the Todoist integration:
- Go to the Todoist integration page in aura
- Click the "Info" tab
- Scroll down and click "Unlink Todoist"
- Confirm the disconnection
- You'll be redirected to the Integrations page
Note: Disconnecting will:
- Remove access to Todoist data in aura
- Stop syncing tasks
- Prevent you from managing tasks through aura
- Not affect your Todoist account or existing tasks
Troubleshooting
Connection Failed
Possible causes:
- Incorrect API token
- Token was revoked
- Network connectivity issues
- Todoist service temporarily unavailable
Solutions:
- Verify you copied the complete API token
- Check that the token hasn't been revoked in Todoist
- Try copying the token again from Todoist settings
- Check your internet connection
- Wait a few minutes and try again
Search Not Returning Results
Possible causes:
- No tasks match your search criteria
- Tasks are in archived projects
- Sync delay
- Integration not fully connected
Solutions:
- Try broader search terms
- Check that tasks exist in your Todoist account
- Verify the integration status is "Connected"
- Refresh the page and try again
- Check if tasks are in active (not archived) projects
Cannot Create or Update Tasks
Possible causes:
- Token invalid or expired
- Insufficient permissions
- Project doesn't exist
- Network issues
Solutions:
- Verify integration status is "Connected"
- Update your API token if needed
- Check that the project name is correct
- Ensure you have permission to modify tasks
- Try again with simpler commands
Tasks Not Syncing
Possible causes:
- Token expired
- Sync delay
- Network interruption
- Todoist API rate limiting
Solutions:
- Check integration status for errors
- Update your API token
- Wait a few moments for sync to complete
- Disconnect and reconnect the integration
- Contact support if issue persists
Security & Permissions
What aura Can Access
With the Todoist integration, aura can:
- Read all your tasks and projects
- Create new tasks and projects
- Update existing tasks
- Complete and delete tasks
- Access task metadata (due dates, priorities, labels)
What aura Cannot Access
aura respects Todoist's data model and cannot:
- Access other users' tasks (in shared projects)
- Modify Todoist account settings
- Access billing information
- Share projects on your behalf
Token Security
Your Todoist API token is:
- Encrypted in transit and at rest
- Never exposed in logs or error messages
- Only used to authenticate with Todoist APIs
- Revocable at any time from your Todoist settings
Privacy Considerations
- Your tasks remain private and are not shared
- aura only accesses data you explicitly connect
- Task data is used only for search and automation
- You can disconnect at any time
Best Practices
Token Management
- Keep your API token secure and private
- Don't share your token with others
- Regenerate your token if you suspect it's compromised
- Update the token in aura immediately after regenerating
Task Organization
- Use clear, descriptive task names
- Organize tasks into projects for better management
- Use labels to categorize tasks
- Set due dates for time-sensitive tasks
- Use priorities to highlight important tasks
Search Efficiency
- Use specific keywords when searching
- Include project names for targeted searches
- Leverage labels and priorities in queries
- Use date-based searches for time management
Task Creation
- Be specific in task descriptions
- Include due dates when creating tasks
- Assign appropriate priorities
- Use labels for better organization
- Specify projects to keep tasks organized
Advanced Features
Natural Language Due Dates
Todoist supports natural language for due dates:
Examples:
- "Create task: Review report, due tomorrow"
- "Add task: Team meeting, due next Monday"
- "Create task: Submit proposal, due in 3 days"
Priority Levels
Todoist has 4 priority levels:
- P1 (Highest): Urgent and important tasks
- P2 (High): Important tasks
- P3 (Medium): Normal tasks
- P4 (Low): Low priority tasks
Example: "Create high-priority task: Fix critical bug"
Labels and Filters
Use labels to organize and filter tasks:
Examples:
- "Show me tasks with label 'urgent'"
- "Find tasks labeled 'waiting' in Work project"
- "Create task with labels 'urgent' and 'client'"
Recurring Tasks
Create recurring tasks with natural language:
Examples:
- "Create task: Weekly team standup, every Monday"
- "Add task: Monthly report, due last day of month"
- "Create task: Daily review, every day at 5pm"
Integration Tips
Combining with Other Integrations
Leverage Todoist with other aura integrations:
- Email: "Create task from this email: Follow up with client"
- Calendar: "Add my Todoist tasks to my calendar"
- Jira: "Create Jira issue from Todoist task 'Fix bug'"
- Notion: "Add Todoist tasks to my Notion project tracker"
Productivity Workflows
Use aura to create powerful workflows:
- Email to Task: Convert emails to Todoist tasks automatically
- Meeting Follow-ups: Create tasks from calendar events
- Project Tracking: Link Todoist tasks with Jira issues
- Daily Planning: Review and organize tasks each morning
Smart Queries
Ask intelligent questions about your tasks:
Examples:
- "What should I focus on today?"
- "Show me my most important tasks this week"
- "What tasks are blocking other work?"
- "Which projects have the most overdue tasks?"
Need Help?
- Integrations Overview - General integration information
- Dashboard Guide - Understanding integration status
- FAQ - Common questions
- Troubleshooting - Solutions to common issues
- Todoist Help - Official Todoist documentation
Connect your Todoist account to aura and experience seamless task management integrated with all your work tools.