Overview

MCP Warrior is the community name for the TaskWarrior MCP server published by kaierikniermann on LobeHub. It is a lightweight Model Context Protocol (MCP) server that wraps the official TaskWarrior command-line tool (task).

This server allows AI assistants and agents (Claude Desktop, Cursor, and other MCP-compatible clients) to interact with your personal task database using natural language while keeping all data 100% local and private.

It provides structured, project-scoped access to tasks, making it ideal for GTD (Getting Things Done) workflows, personal productivity, and AI-augmented task management.

Key Features

Native TaskWarrior Integration: Directly executes and parses the local task CLI binary.
Structured & Project-Scoped Access: Tools respect projects, tags, priorities, due dates, and dependencies.
Natural Language Task Management: AI can list pending tasks, add new ones, update status, annotate, or complete tasks in one conversation.
Local & Private: Runs entirely on your machine — no cloud, no data sharing.
Easy MCP Discovery: Automatically exposes tools for AI clients to discover and use.
Lightweight: Minimal dependencies and fast response times.

How It Works

The server acts as a bridge between the MCP standard and TaskWarrior. When connected to an AI client, the LLM receives a list of available tools (e.g., list tasks by project, add task with due date, mark complete). The server translates tool calls into precise task commands and returns clean, LLM-friendly results.

Installation & Setup

Ensure TaskWarrior is installed and the task command is available in your PATH.
Connect the server via LobeHub or directly in your MCP client (Claude, Cursor, etc.) using the kaierikniermann-taskwarrior-mcp entry.
Authorize and start using natural language prompts like:
- "Show me all overdue tasks in the Work project"
- "Add a high priority task: Prepare Q2 report due next Friday"
- "Complete task 42 and add a note about the outcome"

Available Capabilities

List/filter tasks (by project, tags, status, priority, due date)
Create new tasks with rich metadata
Update existing tasks
Mark tasks as completed or delete them
Project-scoped views and organization

Exact tools may vary slightly by version but focus on clean, structured task operations optimized for AI agents.

Use Cases

Personal GTD Users: Let Claude act as your intelligent task assistant.
Developers: Manage coding tasks and todos directly from Cursor while building projects.
Knowledge Workers: Keep AI agents grounded in your real task list for planning and follow-ups.
Multi-MCP Workflows: Combine with Notion MCP, calendar servers, or GitHub MCP for end-to-end agentic productivity.

Why Choose MCP Warrior?

It stands out for its simplicity, strict locality, and faithful wrapping of the battle-tested TaskWarrior engine. Unlike heavier or cloud-based alternatives, it gives power users full control while making TaskWarrior accessible to modern AI interfaces.

Requirements

TaskWarrior CLI installed
Node.js environment (for most MCP runners)
An MCP-compatible AI client (Claude Desktop recommended)

Getting Started

Visit the listing on LobeHub to add MCP Warrior to your AI tools instantly. Experience seamless, private task management powered by the Model Context Protocol.

Perfect for anyone who loves TaskWarrior’s power but wants AI to help manage it effortlessly.