TaskWarriorSAFE

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 si