taskwarrior-mcp

MCP.Pizza Chef: acebaggins

Taskwarrior MCP is a server integration that exposes Taskwarrior's task management capabilities to LLMs via the Model Context Protocol. It supports task creation, modification, deletion, querying, filtering, dependency management, annotations, recurrence handling, and real-time updates. It also features smart prompts with autocompletion, enabling seamless, interactive task workflows within AI-enhanced environments.

Unmaintained · No commits in 19 months.

Use This MCP server To

Create, modify, and delete tasks via natural language commands Query and filter tasks dynamically for project management Manage task dependencies and track progress automatically Add annotations and notes to tasks for detailed context Handle recurring tasks with automated scheduling Receive real-time updates on task status changes Use smart prompts with autocompletion for faster task input

README

Taskwarrior MCP

An MCP for Taskwarrior.

Features

  • Task creation, modification, and deletion
  • Task querying and filtering
  • Task dependency management
  • Task annotations and notes
  • Task recurrence handling
  • Real-time task updates
  • Smart prompts with autocompletion

Installation

npm install @tfr/taskwarrior-mcp

Usage

With npx

npx taskwarrior-mcp

Config

Notes for Claude Desktop

The way Claude Desktop loads an MCP is by spawning a new process, not a shell process, so it doesn't have any of your env info. If you use something like mise then nothing works and the error messages aren't great.

Some people suggest hardcoding in the paths, which works, I suppose, but I took the fix from here and launch Claude with open -a Claude (hopefully from a terminal profile where you won't regret it).

Add this to your config (claude_desktop_config.json):

taskwarrior-mcp FAQ

How do I install the Taskwarrior MCP server?
Install it using npm with `npm install @tfr/taskwarrior-mcp` or run directly via `npx taskwarrior-mcp`.
Can Taskwarrior MCP handle recurring tasks?
Yes, it supports task recurrence handling to automate repeated task scheduling.
How does Taskwarrior MCP provide real-time updates?
It streams task status changes and updates instantly to connected clients for live synchronization.
What is the purpose of smart prompts in Taskwarrior MCP?
Smart prompts offer autocompletion and context-aware suggestions to speed up task creation and modification.
How do I configure Taskwarrior MCP with Claude Desktop?
Launch Claude Desktop from a terminal with environment variables set, e.g., using `open -a Claude`, and configure paths as needed in `claude_desktop_config.json`.
Does Taskwarrior MCP support task dependency management?
Yes, it allows managing and querying task dependencies to maintain project workflows.
Is Taskwarrior MCP compatible with other LLM providers?
Yes, it works with models like OpenAI, Claude, and Gemini through the MCP protocol.
Can I use Taskwarrior MCP to annotate tasks?
Yes, it supports adding notes and annotations to tasks for richer context.