# Todoist Integration
Connect Todoist to Zaphiri to bring your Todoist tasks into Zaphiri's day-first planning. Browse your Todoist projects in the sidebar and drag tasks straight into your daily plan.
> [!quote] Bring in what matters
> Use Todoist to capture and organise tasks, and Zaphiri to ==decide which day they belong to==. Each tool does the job it is good at.
## How the Todoist integration works
The Todoist integration uses a **browse-and-import** workflow, like the [[ClickUp]] integration:
### Sidebar browser
Once connected, a **Todoist tab** appears in the right sidebar next to your existing tabs (Inbox, Notes, Calendar, ClickUp). From here you can:
- **Browse projects**: select any Todoist project to see its tasks
- **Search tasks**: filter tasks by name within a project
- **Favourite projects**: pin projects you use often for quick access
- **View task details**: see the priority, project and creation date for each task
### Drag to plan
- **Drag from the sidebar**: press and hold any Todoist task, then drag it into a day column in Week or List view
- **Daily Planning**: during [[Daily Planning]], drag Todoist tasks from the sidebar into your Today column
- **Task card link**: imported tasks show a Todoist icon. Select it to open the original task in Todoist
> [!tip] What you get
> **Your existing habits**: keep using Todoist for capture and organisation
> **Day-first planning**: plan your Todoist tasks around your energy with Zaphiri
> **Time tracking**: track the actual time spent on Todoist tasks with Zaphiri's timer
> **Quick switch**: select the Todoist icon on any imported task to jump back to Todoist
## Setting up the Todoist integration
![[integrations-task-section.png]]
Todoist connects from **Settings → Integrations**, under Task Integration.
### Initial connection
1. **Open Zaphiri Settings**: select the profile icon in the top right
2. **Go to Integrations**: select the Integrations section
3. **Connect Todoist**: select the Todoist integration toggle
4. **Sign in to Todoist**: sign in with your Todoist account through OAuth
5. **Grant permissions**: allow Zaphiri to read your Todoist projects and tasks
### Checking the connection
Once connected, you should see:
- **Todoist tab**: in the right sidebar panel
- **Connection status**: shown as connected in [[Integration Settings]]
- **Project access**: you can browse all your Todoist projects and tasks
## Working with Todoist tasks
### During Daily Planning
Use the [[Daily Planning]] sidebar to pull in Todoist tasks:
1. **Open the Todoist tab** in the right sidebar
2. **Browse or search** for the tasks you want to work on today
3. **Drag tasks** into your Today column
4. **Set planned times** in Zaphiri so the day stays realistic
5. **Select Optimize Schedule** to order your day around your energy
### In Week view and List view
- Drag Todoist tasks from the sidebar into any day column
- Imported tasks show the Todoist icon so you can spot them quickly
- Select the icon to open the original task in Todoist
### Task details
When you import a Todoist task and open it in the edit modal, you see a **Todoist details block** showing:
- **Priority level**: the task's Todoist priority (P1 to P4)
- **Project**: the Todoist project the task belongs to
- **Created date**: when the task was first created in Todoist
> [!note] Privacy-first design
> Zaphiri connects to Todoist as a planning layer. It doesn't copy or store your Todoist data. Your time tracking, planning and notes stay in Zaphiri, and your tasks stay in Todoist. Learn more: [[Privacy-First Integrations]].
## Troubleshooting
> [!warning] Common issues
> **Can't see the Todoist tab**: check your Todoist connection in Settings → Integrations
> **Projects not loading**: check your internet connection and your Todoist account permissions
> **Tasks missing**: make sure you have access to the Todoist project. Shared projects need the right permissions
> **Connection lost**: disconnect and reconnect the integration from Settings → Integrations
---
**Next:** Connect your calendar with [[Google|Google Integration]].