What is Mcp Server Taskwarrior

mcp-server-taskwarrior is a Node.js server that implements the Model Context Protocol (MCP) for managing tasks in TaskWarrior, allowing users to interact with their task lists through a structured API.

Use cases

Use cases include retrieving current work tasks, adding high-priority tasks, and marking tasks as completed, enabling users to efficiently manage their to-do lists.

How to use

To use mcp-server-taskwarrior, first install it via npm with the command ‘npm install -g mcp-server-taskwarrior’. Ensure that TaskWarrior is installed and configured on your system. You can then integrate it with applications like Claude Desktop by adding the necessary configuration to ‘claude_desktop_config.json’.

Key features

Key features include viewing pending tasks, filtering tasks by project and tags, adding new tasks with detailed attributes (description, due dates, priorities, projects, and tags), and marking tasks as complete.

Where to use

mcp-server-taskwarrior can be used in project management, personal productivity applications, and any environment where task tracking and management are required.

TaskWarrior MCP Server

Node.js server implementing Model Context Protocol (MCP) for TaskWarrior operations.

Features

• View pending tasks
• Filter tasks by project and tags
• Add new tasks with descriptions, due dates, priorities, projects and tags
• Mark tasks as complete

Note: This runs your local task binary, so TaskWarrior needs to be installed and configured!

[!WARNING]
This currently uses task id which is an unstable identifier; taskwarrior
sometimes renumbers tasks when new ones are added or removed. In the future
this should be more careful, using task UUID instead.

API

Tools

• get_next_tasks

  • Get a list of all pending tasks
  • Optional filters:
    • project: Filter by project name
    • tags: Filter by one or more tags

• add_task

  • Add a new task to TaskWarrior
  • Required:
    • description: Task description text
  • Optional:
    • due: Due date (ISO timestamp)
    • priority: Priority level (“H”, “M”, or “L”)
    • project: Project name (lowercase with dots)
    • tags: Array of tags (lowercase)

• mark_task_done

  • Mark a task as completed
  • Required:
    • identifier: Task ID or UUID

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "taskwarrior": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-taskwarrior"
      ]
    }
  }
}

Installation

npm install -g mcp-server-taskwarrior

Make sure you have TaskWarrior (task) installed and configured on your system.

Example usage ideas:

• What are my current work tasks?
  • Executes: task project:work next
• TODO: Call my sister (high priority)
  • Executes: task add priority:H Call my sister
• OK, I’ve called my sister
  • Executes: task done 1

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.