# Todoist MCP

> Todoist connects your task lists and projects directly into your chat environment. Stop switching apps to manage your day; view pending tasks, add new action items, or mark things as done using simple conversations with your AI client. You'll keep track of everything—from project sections to labels—all without opening the actual Todoist app.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, to-do-list, personal-productivity, task-tracking, workflow-automation, reminders

## Description

You can bring your entire personal and team task list into your chat window. This MCP lets you view what needs doing, manage projects, and update tasks using nothing but plain conversation with your AI client. You never have to jump between apps just to check a deadline or add a quick reminder.

Need to quickly record an idea? Just ask your agent to create a task for your inbox. Want to know which project you were working on last week, or what labels are available for categorization? Your agent handles it all. Because Vinkius hosts this MCP, you get access to the full power of Todoist’s organization system right where you already work.

It's about staying in your workflow and letting your AI client handle the tedious administrative stuff—marking things complete, listing project folders, or reading through past comments for context. You just talk to it, and your tasks get managed.

## Tools

### complete_task
Marks a task as finished and removes it from your active list.

### create_task
Adds a brand new to-do item, letting you specify which project folder it goes into.

### list_comments
Retrieves and displays the full discussion history attached to any specific task.

### list_labels
Shows you all the customizable tags or labels you have set up across your accounts.

### list_projects
Lists every active project folder that currently exists in your Todoist account.

### list_sections
Displays all the organized sections found within a specific project you choose.

### list_tasks
Retrieves a list of your pending tasks, and you can narrow that list down by specifying a project ID.

## Prompt Examples

**Prompt:** 
```
Check all my active tasks and projects.
```

**Response:** 
```
I've retrieved 3 projects (Personal, Work, Grocery). Under your Inbox, you have 1 active task:
- Task: 'Summarize weekly sync', ID: 81229
```

**Prompt:** 
```
Complete the task with ID 81229.
```

**Response:** 
```
I have successfully marked the task 81229 as completed in your Todoist workspace.
```

## Capabilities

### Track Project Structures
You can list all active projects, see their specific sections, and view every label you use.

### View and Update Tasks
Check your full pending task list or mark any existing item as complete instantly.

### Create New Items
Add brand-new tasks directly to a specific project folder or your general inbox through conversation.

### Review Discussion History
Read all the comments attached to any task so you don't miss important context.

## Use Cases

### The End-of-Day Triage
You finish a deep work session and need to capture all pending items. You ask your agent to use list_tasks, review the results, and then create_task for anything that needs follow-up tomorrow morning.

### Catching Up on Team Decisions
You are back in the office after vacation and need to know what happened with Project X. You ask your agent to list_comments for the main task, getting a full summary of decisions without opening the web app.

### Project Audit Prep
You are setting up a new board and realize you need to know every label available. You run list_labels to get a quick rundown of all existing tags, ensuring consistency across your whole workflow.

### Checking Scope Creep
A teammate mentions an old task ID number, but you can't recall the project. You use list_projects and then follow up with list_sections to pinpoint exactly where that item belongs.

## Benefits

- Get instant context. Instead of clicking into a task just to read history, you can use list_comments to pull all discussions right into your conversation flow.
- Stay organized by location. List_sections lets you see exactly what folders are inside a project before you even start working on it. No guessing needed.
- Never forget an idea again. Just ask the agent to create_task, and you can drop notes directly into a specific project or your general inbox in plain text.
- Keep up with massive projects. List_projects lets you see every active folder at a glance, helping you know exactly where all your work is split across different contexts.
- Clean up fast. When a task is done, just tell your agent to complete_task and it handles the update for you, keeping your list accurate without manual clicks.

## How It Works

The bottom line is you talk to your AI agent, and it talks directly to Todoist to handle the task management.

1. Subscribe to this MCP on Vinkius and generate your personal Todoist API Token.
2. Plug that token into your setup, giving your AI client permission to manage your tasks.
3. Ask your agent a question like, 'What are my pending tasks in the Work project?' and get an immediate list.

## Frequently Asked Questions

**How do I check my tasks using Todoist MCP?**
You can use list_tasks to get a full view of your pending items. You can even filter that list by providing a specific project ID, narrowing down the focus immediately.

**Can I add tasks through Todoist MCP?**
Yes, you can easily create_task directly from conversation. Just tell your agent what you need to do and which project folder it should belong in.

**Does this MCP help me see all my projects?**
Absolutely. Use list_projects to get a complete roster of every active folder you have set up, so you know exactly where your work is organized.

**What if I need to mark something as done using Todoist MCP?**
You simply tell your agent to complete_task for the item ID. It marks it finished in Todoist and keeps your task list current, which saves you clicks.

**How do I view comments on a specific task with Todoist MCP?**
You use list_comments to pull up all previous discussion history for that single task. This is great for catching up quickly without opening the full app.