SSyncDev

Taskwarrior MCP Server

MCP server for Taskwarrior, with optional Timewarrior time reporting.

Local serverstdioPython

What is the Taskwarrior MCP Server?

MCP server for Taskwarrior, with optional Timewarrior time reporting.

What you get

Published on npm — no clone or build required. Point your MCP client at it with npx:

Configuration and credentials

  • Node.js ≥ 20 - Taskwarrior 3.x (task on PATH) - Timewarrior (timew on PATH) — optional; enables the time-summary tool - Python 3 — optional; only for Taskwarrior's Timewarrior hook (time tracking)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Taskwarrior MCP Server

{
  "mcpServers": {
    "taskwarrior": {
      "command": "npx",
      "args": ["-y", "@gabz-araujo/taskwarrior-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js ≥ 20 - Taskwarrior 3.x (task on PATH) - Timewarrior (timew on PATH) — optional; enables the time-summary tool - Python 3 — optional; only for Taskwarrior's Timewarrior hook (time tracking)
VariableDescriptionRequired
TASKWARRIOR_PATHFilesystem location the server is allowed to use.Optional
TIMEWARRIOR_PATHFilesystem location the server is allowed to use.Optional

Frequently asked questions

MCP server for Taskwarrior, with optional Timewarrior time reporting. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.