MCP.directory
TaskWarrior

TaskWarrior

awwaiid

Connects to your local Taskwarrior installation to manage tasks directly from your AI assistant. Lets you add, update, delete, and view tasks with project organization and priority levels.

Integrates with TaskWarrior to enable viewing, adding, and completing tasks, facilitating automated task management for productivity and project workflows.

43749 views10Local (stdio)
productivity
GitHub

What it does

  • Add new tasks to Taskwarrior
  • Update existing task details
  • Delete completed or unwanted tasks
  • List tasks with project and priority filtering
  • Organize tasks by projects
  • Set and modify task priorities

Best for

GTD practitioners using TaskwarriorCommand-line users managing personal tasksDevelopers integrating task management into AI workflows
Works with existing Taskwarrior setupNo cloud dependency - purely local

About TaskWarrior

TaskWarrior is a community-built MCP server published by awwaiid that provides AI assistants with tools and capabilities via the Model Context Protocol. Boost productivity and streamline projects with TaskWarrior integration—your go-to project management software for autom It is categorized under productivity. This server exposes 3 tools that AI clients can invoke during conversations and coding sessions.

How to install

You can install TaskWarrior in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

TaskWarrior is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

Tools (3)

get_next_tasks

Get a list of all pending tasks

mark_task_done

Mark a task as done (completed)

add_task

Add a new task

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.

Alternatives

GitHub

GitHub

github
27.6k

Extend your developer tools with GitHub MCP Server for advanced automation, supporting GitHub Student and student packag

OfficialRemotePopular
4.2k212
Task Master

Task Master

eyaltoledano
25.8k

Boost productivity with Task Master: an AI-powered tool for project management and agile development workflows, integrat

CommunityPopular
4.7k112
Mastra Docs

Mastra Docs

mastra-ai
21.8k

Mastra Docs: AI assistants with direct access to Mastra.ai’s full knowledge base for faster, smarter support and insight

OfficialPopular
3321
Beads

Beads

steveyegge
18.6k

Beads — a drop-in memory upgrade for your coding agent that boosts context, speed, and reliability with zero friction.

OfficialPopular
7423

Related Skills

Browse all skills
chief-architect

PERSONAL APP ARCHITECT - Strategic development orchestrator for personal productivity applications. Analyzes project context, makes architectural decisions for single-developer projects, delegates to specialized skills, and ensures alignment between user experience goals and technical implementation. Optimized for personal apps targeting 10-100 users.

0
personal-analytics

Analyze conversation patterns, track productivity, and surface self-knowledge insights. Use when user wants to understand their own patterns (when they chat, what topics they discuss, productivity trends, sentiment over time). Provides weekly/monthly reports, topic recommendations, and time-based insights. Privacy-first design with all analysis local.

0
windsurf-extension-pack

Install and configure essential Windsurf extensions for productivity. Activate when users mention "install extensions", "setup windsurf plugins", "configure extensions", "extension recommendations", or "productivity extensions". Handles extension installation and configuration. Use when working with windsurf extension pack functionality. Trigger with phrases like "windsurf extension pack", "windsurf pack", "windsurf".

0
cto-engineering-metrics

Expert methodology for defining, tracking, and interpreting engineering performance metrics including DORA, team health, productivity, and executive reporting.

0
email-management-expert

Expert email management assistant for Apple Mail. Use this when the user mentions inbox management, email organization, email triage, inbox zero, organizing emails, managing mail folders, email productivity, checking emails, or email workflow optimization. Provides intelligent workflows and best practices for efficient email handling.

0
windsurf-usage-analytics

Analyze team AI usage patterns and productivity metrics. Activate when users mention "usage analytics", "ai metrics", "productivity tracking", "usage reports", or "roi analysis". Handles analytics and reporting configuration. Use when working with windsurf usage analytics functionality. Trigger with phrases like "windsurf usage analytics", "windsurf analytics", "windsurf".

0