home / mcp / mcp taskwarrior mcp server

MCP Taskwarrior MCP Server

Provides a simple MCP Server that manages Taskwarrior tasks via add, update, delete, and list actions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "0xbeedao-mcp-taskwarrior": {
      "command": "npx",
      "args": [
        "@0xbeedao/mcp-taskwarrior"
      ]
    }
  }
}

You have a lightweight MCP Server that helps you manage Taskwarrior tasks directly from MCP clients. It exposes four tools to add, update, delete, and list tasks, making it easy to perform common Taskwarrior operations from your MCP workflows.

How to use

Use this server with your MCP client by selecting a Command style MCP, then point the client to the path that contains the server’s code as the argument for the task interface. You can run the server locally or connect to it remotely if you host it somewhere accessible by your MCP client.

How to install

Prerequisites: Node.js and a package manager installed on your system.

cd mcp-taskwarrior
pnpm install

Notes

When you use a MCP client, you can reference the server by its standard MCP command invocation. For a quick start, you can run the MCP using the recommended one-liner shown below to try the server directly, or install locally to develop and test it further.

npx @0xbeedao/mcp-taskwarrior

Available tools

add_task

Adds a new Taskwarrior task with specified details. This tool creates a new task entry in Taskwarrior via the MCP interface.

update_task

Updates fields on an existing Taskwarrior task identified by its ID or unique key. You can modify status, priority, due date, or other task attributes.

delete_task

Deletes a Taskwarrior task by its ID or identifier, removing it from the Taskwarrior list.

list_tasks

Retrieves and returns a list of current Taskwarrior tasks, optionally filtered by priority, project, or status.