Log inSubmit server
MCP Server Taskwarrior logo

MCP Server Taskwarrior

by awwaiid

Manage local TaskWarrior tasks through MCP by listing, filtering, adding, and completing tasks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Taskwarrior

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "awwaiid-mcp-server-taskwarrior": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-taskwarrior"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y mcp-server-taskwarrior

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The awwaiid/mcp-server-taskwarrior MCP server exposes local TaskWarrior operations through MCP tools. It lists pending tasks, filters them by project or tags, adds tasks with optional scheduling and categorization fields, and marks tasks complete. The Node.js server runs the local `task` binary, so TaskWarrior must already be installed and configured. Use it when an MCP client needs access to a local TaskWarrior task list rather than a hosted task-management service.

Use cases

  • List pending tasks for a project
  • Filter work by TaskWarrior tags
  • Add tasks with due dates and priorities
  • Mark completed tasks from an MCP client

Key features

  • List pending TaskWarrior tasks
  • Filter by project
  • Filter by multiple tags
  • Add tasks with due dates and priorities
  • Mark tasks complete by ID or UUID

Tools6

What MCP Server Taskwarrior lets your agent do. Expand a tool for its parameters.

Self-reported~46 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 1

Scanned 9d ago via OSV.dev · mcp-server-taskwarrior (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars51Stargazers on the source repository.
npm downloads217Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed6Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Taskwarrior works

What awwaiid/mcp-server-taskwarrior MCP server does

The awwaiid/mcp-server-taskwarrior MCP server connects an MCP client to a local TaskWarrior installation. It supports a focused set of task operations: viewing pending work, creating tasks, and completing tasks. This makes it suitable for assistants that need to read or update a developer’s local task list without introducing a separate hosted task system.

The server exposes three tools:

  • get_next_tasks returns pending tasks and can filter them by project or by one or more tags.
  • add_task creates a task. A description is required; due date, priority, project, and tags are optional.
  • mark_task_done completes a task using an ID or UUID as the identifier.

How it works

The awwaiid/mcp-server-taskwarrior MCP server is implemented in Node.js and executes the local task command for TaskWarrior operations. MCP-compatible clients call the exposed tools, while TaskWarrior remains responsible for storing and managing the task data on the local system.

Task creation accepts an ISO timestamp for due. Priority values are limited to H, M, or L. Project names and tags are expected to use lowercase values; project names may contain dots. Pending-task queries can be narrowed to a project or to multiple tags.

The repository’s example client configuration uses npx to start the server.

Setup and configuration

Install and configure TaskWarrior first, ensuring the task binary is available on the machine where the MCP server runs. The awwaiid/mcp-server-taskwarrior MCP server does not replace the TaskWarrior installation or configuration.

For Claude Desktop, add a server entry that runs npx -y mcp-server-taskwarrior. The -y option accepts the package installation prompt automatically. No environment variables or API credentials are specified by the project material.

Tools and capabilities

Use get_next_tasks to retrieve all pending tasks or limit results with project and tags filters. Use add_task when an assistant needs to create a task with a required description and optional due date, priority, project, or tags. Use mark_task_done to complete a task by supplying its identifier.

Limitations and notes

The awwaiid/mcp-server-taskwarrior MCP server currently relies on TaskWarrior’s numeric task ID in some operations. The README warns that IDs can change when tasks are added or removed, making them unstable. UUID support is mentioned as a future direction, although the completion tool accepts either a task ID or UUID.

This is a local integration: TaskWarrior must be installed and configured, and the server runs the local executable.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Taskwarrior

Run `npm install -g mcp-server-taskwarrior`, or configure the server with `npx -y mcp-server-taskwarrior` as shown for Claude Desktop. TaskWarrior must also be installed and configured.

Yes. The README provides a Claude Desktop configuration using the `npx -y mcp-server-taskwarrior` command.

It can list pending tasks, filter them by project or tags, add tasks with optional due dates, priorities, projects, and tags, and mark tasks complete.

Yes. The server runs the local `task` binary, so TaskWarrior must be installed and configured on the host system.

No. The README warns that TaskWarrior can renumber task IDs when tasks are added or removed. UUID support is identified as a future improvement.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Taskwarrior AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/awwaiid-mcp-server-taskwarrior?style=directory)](https://allmcps.com/mcp/awwaiid-mcp-server-taskwarrior)
HTML Embed
<a href="https://allmcps.com/mcp/awwaiid-mcp-server-taskwarrior"><img src="https://allmcps.com/api/badge/awwaiid-mcp-server-taskwarrior?style=directory" alt="MCP Server Taskwarrior on AllMCPs" /></a>