mcp-server-taskwarrior MCP Server

Use This MCP server To

View pending TaskWarrior tasks through MCP-enabled apps Filter tasks by project or tags for focused task management Add new tasks with descriptions, due dates, and priorities Mark tasks as complete via natural language commands Integrate TaskWarrior task data into AI workflows Automate task updates and queries using LLMs Build custom task dashboards with real-time task data

README

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 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.

mcp-server-taskwarrior FAQ

How does mcp-server-taskwarrior interact with TaskWarrior?

It runs your local TaskWarrior binary to execute commands and fetch task data.

Do I need to install TaskWarrior separately?

Yes, TaskWarrior must be installed and configured locally for this MCP server to function.

Can I filter tasks by project or tags?

Yes, the server supports filtering pending tasks by project name and tags.

How are tasks identified in this server?

Currently, tasks are identified by their TaskWarrior 'id', which may be unstable; future versions aim to use UUIDs.

Is this server compatible with multiple LLM providers?

Yes, it works with any MCP-compatible client using models like OpenAI, Claude, and Gemini.

Can I add tasks with detailed attributes?

Yes, you can add tasks specifying descriptions, due dates, priorities, projects, and tags.

Does this server support marking tasks as complete?

Yes, it provides functionality to mark tasks as completed through MCP commands.

Is the server limited to local TaskWarrior installations?

Yes, it requires a local TaskWarrior installation since it executes the local 'task' binary.