TaskWarrior MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Allows interaction with TaskWarrior, providing tools for viewing pending tasks, filtering tasks by project and tags, adding new tasks with descriptions and metadata, and marking tasks as complete.
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 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
:
Installation
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.
You must be authenticated.
Node.js server implementing Model Context Protocol that enables interaction with TaskWarrior through natural language to view, filter, add, and complete tasks.