Taskwarrior MCP

A local MCP server that wraps the Taskwarrior CLI, giving an assistant project-scoped tools to add, list, search, modify, complete and delete tasks.

What you can do

Add tasks with description, project, due date, tags, priority, wait and scheduled fields, and annotate existing tasks with notes. List and search tasks within a project, with filters, virtual tags such as overdue or due, and reports like next, list, all, completed, waiting and blocked. Fetch a single task by ID, modify its fields, mark it complete, or delete it. Every read and write is scoped to a project unless the all_projects opt-out is set.

When to use it

Useful when you keep tasks in Taskwarrior and want an assistant to read and manage them conversationally, for example adding tasks, reviewing what is due or overdue, or updating and closing items in a specific project.

Requirements

Runs as a local process on the desktop; the Taskwarrior CLI must be installed and available as task on the PATH. Installing from the MCP registry needs no build step; building from source requires a stable Rust toolchain. No API keys or environment variables are declared.