mcp-server-taskwarrior

1.0.1 • Public • Published

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!

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

  1. List pending tasks:
get_next_tasks {}
  1. Add a new high-priority task due tomorrow:
add_task {
  "description": "Finish project proposal",
  "due": "2024-02-23T17:00:00.000Z",
  "priority": "H",
  "project": "work",
  "tags": ["urgent", "proposal"]
}
  1. Mark task as complete:
mark_task_done {
  "identifier": "123"
}

License

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

Readme

Keywords

none

Package Sidebar

Install

npm i mcp-server-taskwarrior

Weekly Downloads

17

Version

1.0.1

License

MIT

Unpacked Size

9.12 kB

Total Files

3

Last publish

Collaborators

  • awwaiid