mcpField
T
TaskWarrior MCP Server

TaskWarrior MCP Server

Local
github.com/awwaiidProductivity51Updated 31w ago
Repository

About TaskWarrior MCP Server

TaskWarrior MCP Server is a Node.js MCP server for working with local TaskWarrior tasks from an MCP client. It suits users who want to view, add and complete tasks during AI conversations.

Key features

  1. 01List pending tasks
  2. 02Filter tasks by project and tags
  3. 03Add tasks with priority and due date
  4. 04Mark tasks as completed

Use cases

  1. 01Checking current work tasks in a conversation
  2. 02Quickly adding high-priority tasks through chat
  3. 03Updating task status after a conversation

MCP support

The server exposes get_next_tasks, add_task and mark_task_done tools to MCP clients and runs the local task binary underneath.

#taskwarrior#mcp-server#nodejs

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "taskwarrior": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-taskwarrior"
      ]
    }
  }
}
Run commandnpx -y mcp-server-taskwarrior

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-taskwarrior

Tools

3

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

TaskWarrior MCP Server

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

TaskWarrior Server MCP server

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.