# 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]].