TaskWarrior
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.
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
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 a list of all pending tasks
Mark a task as done (completed)
Add a new task
TaskWarrior MCP Server
Node.js server implementing Model Context Protocol (MCP) for TaskWarrior operations.
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
idwhich 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 nametags: 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
- Executes:
- TODO: Call my sister (high priority)
- Executes:
task add priority:H Call my sister
- Executes:
- OK, I've called my sister
- Executes:
task done 1
- Executes:
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Alternatives
Related Skills
Browse all skillsLeveraging AI coding assistants and tools to boost development productivity, while maintaining oversight to ensure quality results.
Creates educational Teams channel posts for internal knowledge sharing about Claude Code features, tools, and best practices. Applies when writing posts, announcements, or documentation to teach colleagues effective Claude Code usage, announce new features, share productivity tips, or document lessons learned. Provides templates, writing guidelines, and structured approaches emphasizing concrete examples, underlying principles, and connections to best practices like context engineering. Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing.
Expert methodology for defining, tracking, and interpreting engineering performance metrics including DORA, team health, productivity, and executive reporting.
This skill should be used whenever users request personal assistance tasks such as schedule management, task tracking, reminder setting, habit monitoring, productivity advice, time management, or any query requiring personalized responses based on user preferences and context. On first use, collects comprehensive user information including schedule, working habits, preferences, goals, and routines. Maintains an intelligent database that automatically organizes and prioritizes information, keeping relevant data and discarding outdated context.
Boost your productivity with automated task management
Optimize local development workflow with Cursor. Triggers on "cursor workflow", "cursor development loop", "cursor productivity", "cursor daily workflow". Use when working with cursor local dev loop functionality. Trigger with phrases like "cursor local dev loop", "cursor loop", "cursor".