TaskWarrior MCP Server logo

TaskWarrior MCP Server

by MCP-Mirror

This is a Node.js server implementing the Model Context Protocol (MCP) for TaskWarrior operations. It allows you to interact with your TaskWarrior tasks through an MCP interface.

View on GitHub

Last updated: N/A

What is TaskWarrior MCP Server?

This server provides an MCP interface to interact with TaskWarrior, a command-line task management tool. It allows other applications, like Claude Desktop, to view, add, and manage tasks in TaskWarrior.

How to use TaskWarrior MCP Server?

First, install the server globally using npm install -g mcp-server-taskwarrior. Ensure TaskWarrior is installed and configured on your system. Then, configure your MCP client (e.g., Claude Desktop) to use this server by specifying the execution command and arguments as shown in the README.

Key features of TaskWarrior MCP Server

  • View pending tasks

  • Filter tasks by project and tags

  • Add new tasks with descriptions, due dates, priorities, projects, and tags

  • Mark tasks as complete

Use cases of TaskWarrior MCP Server

  • Integrating TaskWarrior with AI assistants like Claude

  • Automating task management workflows

  • Creating custom interfaces for TaskWarrior

  • Managing tasks from different applications

FAQ from TaskWarrior MCP Server

What is MCP?

Model Context Protocol (MCP) is a protocol for communication between applications, allowing them to share and manipulate data.

Do I need TaskWarrior installed?

Yes, this server runs your local task binary, so TaskWarrior needs to be installed and configured.

What is the identifier for marking a task done?

Currently, it uses the task id, but it's recommended to use UUID in the future for stability.

How do I filter tasks?

You can filter tasks by project and tags using the get_next_tasks API.

What license is this server under?

This MCP server is licensed under the MIT License.