TaskWarrior MCP Server

1# TaskWarrior MCP Server
2 
3Node.js server implementing Model Context Protocol (MCP) for [TaskWarrior](https://taskwarrior.org/) operations.
4 
5<a href="https://glama.ai/mcp/servers/e8w3e1su1x">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/e8w3e1su1x/badge" alt="TaskWarrior Server MCP server" />
7</a>
8 
9## Features
10 
11- View pending tasks
12- Filter tasks by project and tags
13- Add new tasks with descriptions, due dates, priorities, projects and tags
14- Mark tasks as complete
15 
16**Note**: This runs your local `task` binary, so TaskWarrior needs to be installed and configured!
17 
18> [!WARNING]
19> This currently uses task `id` which is an unstable identifier; taskwarrior
20> sometimes renumbers tasks when new ones are added or removed. In the future
21> this should be more careful, using task UUID instead.
22 
23## API
24 
25### Tools
26 
27- **get_next_tasks**
28  - Get a list of all pending tasks
29  - Optional filters:
30    - `project`: Filter by project name
31    - `tags`: Filter by one or more tags
32 
33- **add_task**
34  - Add a new task to TaskWarrior
35  - Required:
36    - `description`: Task description text
37  - Optional:
38    - `due`: Due date (ISO timestamp)
39    - `priority`: Priority level ("H", "M", or "L")
40    - `project`: Project name (lowercase with dots)
41    - `tags`: Array of tags (lowercase)
42 
43- **mark_task_done**
44  - Mark a task as completed
45  - Required:
46    - `identifier`: Task ID or UUID
47 
48## Usage with Claude Desktop
49 
50Add this to your `claude_desktop_config.json`:
51 
52```json
53{
54  "mcpServers": {
55    "taskwarrior": {
56      "command": "npx",
57      "args": [
58        "-y",
59        "mcp-server-taskwarrior"
60      ]
61    }
62  }
63}
64```
65 
66## Installation
67 
68```bash
69npm install -g mcp-server-taskwarrior
70```
71 
72Make sure you have TaskWarrior (`task`) installed and configured on your system.
73 
74## Example usage ideas:
75 
76* What are my current work tasks?
77  * Executes: `task project:work next`
78* TODO: Call my sister (high priority)
79  * Executes: `task add priority:H Call my sister`
80* OK, I've called my sister
81  * Executes: `task done 1`
82 
83## License
84 
85This MCP server is licensed under the MIT License. See the LICENSE file for details.