https://github.com/awwaiid/mcp-server-taskwarrior
MCP Server for TaskWarrior!
https://github.com/awwaiid/mcp-server-taskwarrior
Last synced: 25 days ago
JSON representation
MCP Server for TaskWarrior!
- Host: GitHub
- URL: https://github.com/awwaiid/mcp-server-taskwarrior
- Owner: awwaiid
- License: mit
- Created: 2025-02-22T15:58:08.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-27T01:23:21.000Z (3 months ago)
- Last Synced: 2026-04-13T01:21:46.885Z (3 months ago)
- Language: JavaScript
- Size: 59.6 KB
- Stars: 46
- Watchers: 3
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - awwaiid/mcp-server-taskwarrior
- awesome-mcp-servers - mcp-server-taskwarrior - An MCP server for local Taskwarrior integration, supporting add, update, and remove task operations through MCP. ([Read more](/details/mcp-server-taskwarrior.md)) `mcp` `task-management` `automation` `open-source` (Project Management MCP Servers)
- awesome-mcp-zh - awwaiid/mcp-server-taskwarrior
- 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 - 基本的なローカルtaskwarrior使用（タスクの追加、更新、削除）のためのMCPサーバー (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
- toolsdk-mcp-registry - ✅ mcp-server-taskwarrior
- awesome-mcp - awwaiid/mcp-server-taskwarrior - An MCP server for basic local taskwarrior usage (add, update, remove tasks) (MCP Servers / 🛠️ Other Tools and Integrations)
- metorial-index - TaskWarrior Server - Manage tasks by viewing, adding, and completing them through applications, with the ability to filter by project and tags. (Task and Project Management)
- awesome-mcp-security - mcp-server-taskwarrior - githubcom-awwaiid-mcp-server-taskwarrior) | (カテゴリ / 🛠️ <a name="developer-tools"></a>開発ツール)
- awesome-devops-mcp - awwaiid/mcp-server-taskwarrior - Basic local taskwarrior usage for task management (🚀 DevOps Productivity)
- awesome-mcp-servers - **mcp-server-taskwarrior** - MCP Server for TaskWarrior! `javascript` `mcp` `server` `local` `http` `npm install awwaiid/mcp-server-taskwarrior` (🌐 Web Development)
- awesome-mcp-servers - TaskWarrior MCP - MCP Server for TaskWarrior! (Table of Contents / System Automation)
- awesome-mcp-servers - awwaiid/mcp-server-taskwarrior - 基本的なローカルtaskwarrior使用（タスクの追加、更新、削除）のためのMCPサーバー (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
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!
> [!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`:
```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 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.