MCP server for Taskwarrior, with optional Timewarrior time reporting.
Taskwarrior MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. MCP server for Taskwarrior, with optional Timewarrior time reporting.
Published on npm — no clone or build required. Point your MCP client at it with npx:
Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.
You will need 2 environment variables: TASKWARRIOR_PATH, TIMEWARRIOR_PATH. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
task on PATH) - Timewarrior (timew on PATH) — optional; enables the time-summary tool - Python 3 — optional; only for Taskwarrior's Timewarrior hook (time tracking)Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by gabz-araujo; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
{
"mcpServers": {
"taskwarrior": {
"command": "npx",
"args": ["-y", "@gabz-araujo/taskwarrior-mcp"]
}
}
}Configuration as documented by the project. Restart the client after saving.
task on PATH) - Timewarrior (timew on PATH) — optional; enables the time-summary tool - Python 3 — optional; only for Taskwarrior's Timewarrior hook (time tracking)| Variable | Description | Required |
|---|---|---|
| TASKWARRIOR_PATH | Filesystem location the server is allowed to use. | Optional |
| TIMEWARRIOR_PATH | Filesystem location the server is allowed to use. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.