TaskWarrior MCP Server
Integrates with TaskWarrior, providing tools for task management, GTD workflow, and habit tracking, including creating, modifying, completing, and listing tasks, managing dependencies, and supporting recurring tasks.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
TaskWarrior MCP Server
MCP server that wraps TaskWarrior command-line tool. Provides 22 tools for task management, GTD workflow, and habit tracking.
Tools
Basic Task Operations
add_task- Create task. Supports GTD fields (context, energy, scheduled, wait, depends) and recurring tasks (recur)modify_task- Update task attributesmark_task_done- Complete task by UUIDdelete_task- Delete task by UUIDlist_tasks- Query tasks with filters (status, project, tags, dates)get_task_details- Get single task by UUIDstart_task- Start timer on taskstop_task- Stop timer on taskadd_annotation- Add note to taskremove_annotation- Remove note from task
Dependencies
add_dependency- Make task A depend on task Bremove_dependency- Remove dependency link
GTD Workflow
get_next_actions- Filter actionable tasks by context, energy level, time availableprocess_inbox- Get tasks tagged +inbox for processingget_waiting_for- Get delegated/waiting tasks, grouped by blocker/date/projectget_blocked_tasks- Get tasks with unmet dependenciesget_project_status- Project metrics: next actions, completion %, stalenessweekly_review- GTD review data: inbox, completed, stalled projects, habitsget_someday_maybe- Get tasks tagged +someday
Batch Operations
create_project_tree- Create project with multiple tasks and dependencies in one callbatch_modify_tasks- Apply same modifications to multiple tasks
Habits/Recurring Tasks
get_recurring_tasks- Get recurring tasks with completion stats, streaks, frequency
Related MCP server: TickTick MCP Server
Requirements
Node.js 18+ for runtime
Bun 1.3+ for development workflows
TaskWarrior installed and available as
task
Install
bun install
bun run buildRun
bun run startOr configure in your MCP client settings:
{
"mcpServers": {
"taskwarrior": {
"command": "node",
"args": ["/path/to/taskwarrior-mcp/dist/index.js"]
}
}
}Claude Desktop Bundle
This repo now includes an MCPB manifest for Claude Desktop.
bun run mcpb:validate
bun run mcpb:packThat produces dist/taskwarrior-mcp.mcpb.
The bundle includes explicit ES module metadata so its JavaScript entry loads on Node 18 as well as newer Node versions.
The bundle packages the MCP server, but it does not bundle TaskWarrior itself. Users still need task installed on the host machine. For non-default setups, the MCPB manifest exposes optional TASK_BIN and TASKRC settings.
Response Format
All tools return MCP standard format:
{
"content": [
{
"type": "text",
"text": "{\"tasks\": [...], \"metadata\": {...}, \"insights\": {...}}"
}
]
}GTD tools return enriched responses with:
tasks- Array of task objectsmetadata- Counts (total, actionable, blocked, waiting, completed)insights- Summary, recommendations, warningsgroups- Tasks grouped by project/context/frequencyrelationships- Dependency chains (where applicable)
GTD Features
Task Fields
scheduled- Date to start workwait- Hide until date (deferred)until- Task expires after datecontext- GTD context (@home, @work, @phone)energy- Energy level required (H/M/L)depends- Array of task UUIDs this depends onparent- Parent task UUIDrecur- Recurrence pattern (daily, weekly, monthly, etc.)tags- Letters, digits,_and-. Tag writes use Taskwarrior'stags:attribute and tag filters usetags.has:, because the+tagshorthand rejects hyphens and silently rewrites the description instead.
Recurring Tasks
Set recur with due to create habits:
{
"description": "Take vitamins",
"recur": "daily",
"due": "today",
"context": "@morning"
}TaskWarrior creates template task (status:recurring) that generates instances. Use get_recurring_tasks to see completion rates and streaks.
Development
bun run typecheck # Type check source
bun run lint # Lint source
bun run test # Run integration tests against disposable Taskwarrior data
bun run build # Build dist/
bun run check # Run typecheck, lint, tests, and buildPull requests and pushes to main run these checks with Taskwarrior installed,
validate and build the MCPB bundle, then run the stdio schema and task-operation
smoke test against its extracted entry point on Node 24.22.1 and Node 18.20.8
on Linux. Build and lint tooling stay on Node 24. Dependencies are audited in a
separate job. Locally, integration tests are skipped if task is missing; the command
diagnostic regression tests still run without it.
Dependency security
bun audit checks development dependencies as well as the server's dependencies.
The tmp override selects the patched 0.2.x release for MCPB's older Inquirer /
external-editor chain. A packaging-dependency regression test covers temporary
file creation, editing, cleanup, and rejection of path traversal in file names.
Remove this override once MCPB's dependency chain selects a patched version itself.
As of November 5, 2026, the full audit reports two development-tooling findings:
GHSA-mrhx-c7xc-m3w5 in MCPB 2.1.2's required Zod 3.25.76. MCPB has not released Zod 4 support. The server resolves Zod 4.6.7 and applies request-array limits; see the compatibility notes for coverage and limitations.
GHSA-g3hv-75wg-m249 in minimatch 10.2.6, used by ESLint and TypeScript ESLint. The advisory requires attacker-controlled glob patterns with optimizationLevel >= 2. The patched 11.0.1 is outside the callers' supported dependency ranges. minimatch is not reachable from the server's production dependency graph.
The earlier node-forge finding is patched by the 1.4.2 override. The audit remains enabled and fails on the current findings. Do not process untrusted packaging inputs or assume development tooling is safe because it is outside the runtime. No incompatible major overrides or audit suppressions are applied.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
This server cannot be deployed
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to interact with the Taskwarrior command-line task management tool. It allows users to list, create, modify, and organize tasks using projects, tags, and annotations through natural language.132MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server for managing TickTick tasks and projects, offering 22 tools for CRUD, search, and GTD workflows via any MCP client.1-
- AlicenseAqualityCmaintenanceMCP server for Taskwarrior 3.x — 35 tools for task lifecycle, time tracking, schema validation, and role-based permissions.3528 PyPI3Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps the Taskwarrior CLI to allow AI assistants to create, query, modify, and manage tasks directly from agentic coding tools.8 npmMIT