Loading...
Create tasks, list projects, manage labels, and close tasks via Todoist REST API
130+ deploysYour AI agent gets 5 capabilities in one connection. Deploy once, use from any client.
GET endpoints
list_tasks
List active tasks. Filter with 'project_id', 'section_id', 'label', or 'filter' (Todoist filter syntax like 'today', 'overdue', 'p1'). Returns id, content, description, is_completed, priority (1-4, where 4=urgent), due (date/datetime/string), labels[], project_id, section_id, parent_id, order, and created_at.
https://api.todoist.com/rest/v2/tasks
list_projects
List all projects. Returns id, name, color, parent_id (for sub-projects), order, is_favorite, is_inbox_project, view_style (list/board), and url. Use project_id to filter tasks or create tasks in a specific project.
https://api.todoist.com/rest/v2/projects
list_labels
List personal labels. Returns id, name, color, order, and is_favorite. Labels can be attached to tasks for cross-project organization. Use label names (not IDs) when creating or updating tasks.
https://api.todoist.com/rest/v2/labels
POST endpoints
create_task
Create a task. Required: 'content' (title). Optional: 'description', 'project_id', 'section_id', 'parent_id' (for subtasks), 'priority' (1=normal, 4=urgent), 'due_string' (natural language: 'tomorrow', 'every monday'), 'due_date' (YYYY-MM-DD), 'labels' (string[]), 'assignee_id', 'duration' and 'duration_unit'. Returns created task with ID.
https://api.todoist.com/rest/v2/tasks
close_task
Mark a task as complete by task_id. Returns 204 No Content on success. For recurring tasks, this completes the current occurrence and schedules the next one automatically. Use 'reopen' endpoint to undo.
https://api.todoist.com/rest/v2/tasks/{task_id}/close
Connect Todoist to Claude Code with one command:
claude mcp add todoist https://datafaucet.dev/api/mcp/t/todoist{notion_token}) with your real credentialsNeed API keys? Try our free sandbox templates first to see MCP in action with zero setup.
Replace these placeholders with your real values before deploying:
{due_string}Your value{priority}Your value{project_id}Resource identifier{task_content}Your value{task_id}Resource identifier{todoist_api_token}API settings pagePreview:
GET https://api.todoist.com/rest/v2/tasks Authorization: Bearer {todoist_api_token}
claude mcp add todoist --url https://datafaucet.dev/api/mcp/t/todoist
Paste into your client's MCP configuration file · most users connect in under 60s
claude mcp add todoist --url https://datafaucet.dev/api/mcp/t/todoistWhat your AI agent sees
I have access to 5 tools from Todoist: list_tasks, create_task, close_task, and 2 more.
“List active tasks. Filter with 'project_id', 'section_id', 'label', or 'filter' (Todoist filter syntax like 'today', 'overdue', 'p1'). Returns id, content, description, is_completed, priority (1-4, where 4=urgent), due (date/datetime/string), labels[], project_id, section_id, parent_id, order, and created_at.”
Calling list_tasks... Done. Here are the results.
Try these prompts
“Show me all tasks due today sorted by priority”
Copy“Create a task 'Review Q3 roadmap' due next Monday in the Work project”
Copy“Close all completed tasks in my Inbox and tell me what's left”
CopyClick any prompt to copy, then paste into your AI client.