Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TODOIST_API_TOKEN | Yes | Your Todoist API token (required for authentication with Todoist API) |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_tasks | Get tasks from Todoist with optional filtering. Args:
project_id: Filter tasks by project ID
section_id: Filter tasks by section ID
label: Filter tasks by label
filter_query: Natural language filter (e.g., 'today', 'overdue', 'p1') |
| get_task | Get a specific task by ID. Args:
task_id: The ID of the task to retrieve |
| create_task | Create a new task in Todoist. Args:
content: The task content/title
description: Detailed description of the task
project_id: Project ID to add the task to
section_id: Section ID within the project
parent_id: Parent task ID (for subtasks)
labels: List of label names
priority: Priority from 1 (normal) to 4 (urgent)
due_string: Human readable due date (e.g., 'tomorrow', 'next Monday')
due_date: ISO 8601 formatted due date |
| update_task | Update an existing task. Args:
task_id: The ID of the task to update
content: Updated task content/title
description: Updated task description
labels: Updated list of label names
priority: Updated priority from 1 (normal) to 4 (urgent)
due_string: Updated human readable due date
due_date: Updated ISO 8601 formatted due date |
| complete_task | Mark a task as completed. Args:
task_id: The ID of the task to complete |
| reopen_task | Reopen a completed task. Args:
task_id: The ID of the task to reopen |
| delete_task | Delete a task. Args:
task_id: The ID of the task to delete |
| get_projects | Get all projects from Todoist. |
| get_project | Get a specific project by ID. Args:
project_id: The ID of the project to retrieve |
| create_project | Create a new project in Todoist. Args:
name: The name of the project
parent_id: Parent project ID (for nested projects)
color: Project color
is_favorite: Whether to mark as favorite |
| get_sections | Get sections from a project. Args:
project_id: Project ID to get sections from (optional) |