todoist_skill

Overview

This skill integrates Todoist with an MCP server so you can add, list, update, and complete tasks programmatically. It supports both an API-token NPX setup for daily use and an HTTP/OAuth option when you prefer temporary authentication. Use the MCP tools to manage projects, sections, comments, and get markdown overviews of your work.

How this skill works

The skill exposes a set of MCP tools prefixed with mcp__todoist__ that call Todoist’s API. The recommended setup uses npx @doist/todoist-ai with TODOIST_API_KEY stored in your config so the server runs without frequent re-authentication. An alternative transport uses HTTP with OAuth for short-lived sessions. Tools handle searching, creating, updating, completing tasks, and project/section management.

When to use it

• Add one or many tasks with rich details (title, description, due dates, priority, labels).
• List today’s tasks or a date range, including overdue items.
• Move or update tasks across projects, sections, priorities, or assignees.
• Get a markdown overview of all projects or a single project.
• Search tasks and projects with full-text queries or filters.

Best practices

• Use the NPX + API token setup (TODOIST_API_KEY) for stable, long-lived access.
• When creating tasks, extract a short imperative title and put context into the description.
• Include natural-language due strings (e.g., "tomorrow at 5pm") for easy parsing.
• Move a task out of Inbox before assigning in shared projects.
• Test connectivity with user-info if an MCP tool shows "failed".

Example use cases

• Quickly add a meeting follow-up task with title, detailed acceptance criteria, and a 2h duration.
• Run find-tasks-by-date startDate: "today" to generate a daily agenda including overdue items.
• Move a set of tasks into a project and then assign responsible users for team handoff.
• Generate a markdown project overview to paste into a status report or meeting notes.
• Search comments or task text across projects to find context for a stalled item.