# mcp-server-taskwarrior

**Repository Path**: mirrors/mcp_server_taskwarrior

## Basic Information

- **Project Name**: mcp-server-taskwarrior
- **Description**: 🏠 📇 - An MCP server for basic local taskwarrior usage (add，update，remove tasks)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-04
- **Last Updated**: 2025-09-13

## Categories & Tags

**Categories**: Artificial-Intelligence, MCP

**Tags**: None

## README

# TaskWarrior MCP Server

Node.js server implementing Model Context Protocol (MCP) for [TaskWarrior](https://taskwarrior.org/) operations.

<a href="https://glama.ai/mcp/servers/e8w3e1su1x">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/e8w3e1su1x/badge" alt="TaskWarrior Server MCP server" />
</a>

## 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.