Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TODOIST_API_TOKEN | Yes | Your Todoist API token. You can find this in your Todoist settings under Integrations > Developer. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_tasks | List tasks with optional filtering by project, label, priority, due date, or custom filter |
| get_task | Get detailed information about a specific task including comments and subtasks |
| create_task | Create a new task with optional due date, priority, labels, and project |
| update_task | Update an existing task (content, due date, priority, labels, etc.) |
| complete_task | Mark a task as complete. For recurring tasks, this completes the current occurrence. |
| uncomplete_task | Reopen a completed task |
| delete_task | Permanently delete a task |
| move_task | Move a task to a different project, section, or make it a subtask |
| list_projects | List all projects in the Todoist account |
| create_project | Create a new project |
| list_sections | List sections within a project |
| create_section | Create a new section within a project |
| update_project | Update an existing project (name, color, favorite status, view style) |
| delete_project | Permanently delete a project and all its tasks |
| update_section | Update a section (rename or collapse/expand) |
| move_section | Move a section to a different project |
| delete_section | Permanently delete a section (tasks will be moved to project root) |
| list_labels | List all labels in the Todoist account |
| create_label | Create a new label |
| update_label | Update an existing label (name, color, favorite status, order) |
| delete_label | Permanently delete a label (tasks will keep their other labels) |
| add_comment | Add a comment to a task |
| get_productivity_stats | Get task completion statistics and productivity insights |
| quick_add | Quickly add a task using natural language. Todoist will parse dates, priorities, labels, and projects from the text. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| daily_planning | Morning planning workflow to review and prioritize your day |
| weekly_review | GTD-style weekly review workflow |
| quick_capture | Rapidly capture multiple tasks or ideas |
| task_breakdown | Break down a large task into actionable subtasks |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| today | Today's tasks including overdue items |
| upcoming | Tasks due in the next 7 days |
| overdue | All overdue tasks requiring attention |
| projects | Project overview with task counts |
| labels | Available labels and usage counts |