https://github.com/awwaiid/mcp-server-taskwarrior
MCP Server for TaskWarrior!
https://github.com/awwaiid/mcp-server-taskwarrior
Last synced: about 2 months ago
JSON representation
MCP Server for TaskWarrior!
- Host: GitHub
- URL: https://github.com/awwaiid/mcp-server-taskwarrior
- Owner: awwaiid
- Created: 2025-02-22T15:58:08.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-02-22T16:32:04.000Z (about 2 months ago)
- Last Synced: 2025-02-22T17:28:57.236Z (about 2 months ago)
- Language: JavaScript
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - awwaiid/mcp-server-taskwarrior - An MCP server for basic local taskwarrior usage (add, update, remove tasks) (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - awwaiid/mcp-server-taskwarrior - An MCP server for basic local taskwarrior usage (add, update, remove tasks) (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - TaskWarrior MCP - MCP Server for TaskWarrior! (Table of Contents / System Automation)
- awesome-mcp-servers - TaskWarrior MCP - MCP Server for TaskWarrior! (Table of Contents / System Automation)
README
# TaskWarrior MCP Server
Node.js server implementing Model Context Protocol (MCP) for [TaskWarrior](https://taskwarrior.org/) 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!
## 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`:
```json
{
"mcpServers": {
"taskwarrior": {
"command": "npx",
"args": [
"-y",
"mcp-server-taskwarrior"
]
}
}
}
```
## Installation
```bash
npm install -g mcp-server-taskwarrior
```
Make sure you have TaskWarrior (`task`) installed and configured on your system.
## Example Usage
1. List pending tasks:
```
get_next_tasks {}
```
2. Add a new high-priority task due tomorrow:
```
add_task {
"description": "Finish project proposal",
"due": "2024-02-23T17:00:00.000Z",
"priority": "H",
"project": "work",
"tags": ["urgent", "proposal"]
}
```
3. Mark task as complete:
```
mark_task_done {
"identifier": "123"
}
```
## License
This MCP server is licensed under the MIT License. See the LICENSE file for details.