Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TODOIST_API_TOKEN | Yes | Your Todoist API token, found in the Todoist Integrations Settings. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_task | Create a new task in Todoist.
Priorities don't map directly to Todoist priorities, but are mapped as follows:
1 = low
2 = medium
3 = high
4 = urgent
This is done to map better to how people think about priorities.
Args:
content: The task content/title (required)
description: Task description (optional)
project_name: Project name to add task to
due_string: Due date in natural language like "tomorrow", "next monday" (optional)
priority: Priority level 1-4 (1=low, 2=medium, 3=high, 4=urgent)
labels: List of label names to add to the task (optional)
Returns:
Dict containing the created task details or error message |
| list_active_tasks | List tasks from Todoist
Args:
project_name: Filter tasks by project name (alternative to project_id)
filter_string: Todoist filter string like "today", "overdue", "p1" (optional)
limit: Maximum number of tasks to return (default 50)
Returns:
Dict containing list of tasks or error message |
| list_completed_tasks | List completed tasks from Todoist within a timespan. Default is last 24 hours.
Prefer not to provide `since` and `until` if you want to pull tasks from the last 24 hours.
Args:
project_name: Filter tasks by project name (optional)
since: Start date in ISO format (YYYY-MM-DD) in the user's timezone (optional)
until: End date in ISO format (YYYY-MM-DD) in the user's timezone (optional)
limit: Maximum number of tasks to return (default 30, max 200)
Returns:
Dict containing list of completed tasks or error message |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |