task-managementtaskwarriorproductivitylocal-tools
Manage local TaskWarrior tasks through MCP by listing, filtering, adding, and completing tasks.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
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
Capabilities & Tool Schemas (6)
Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Server Taskwarrior.
projectFilter by project name
tagsFilter by one or more tags
descriptionTask description text
dueDue date (ISO timestamp)
priorityPriority level ("H", "M", or "L")
identifierTask ID or UUID
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_tasksreturns pending tasks and can filter them by project or by one or more tags.add_taskcreates a task. A description is required; due date, priority, project, and tags are optional.mark_task_donecompletes 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. The README also shows operations corresponding to TaskWarrior commands such as listing work in a project, adding a high-priority task, and completing a task.
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. The provided material documents Claude Desktop usage but does not establish compatibility with other MCP clients.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
51
Stargazers on the source repository.
npm downloads
211
Package downloads in the last 30 days.
Last commit
5mo ago
Most recent push to the default branch.
Tools exposed
6
Callable tools this server registers over MCP.
Directory activity
3 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MCP Server Taskwarrior
AllMCPs Directory Badge
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 Preview
Markdown (GitHub README)
[](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>Technical Specs & Signals
CategoryOther Tools and Integrations
PricingFree
10/10 checks healthy over the last 32d
57Quality signal: Good · 57/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools26/30
Adoption & activity7/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 1
Scanned 21d ago via OSV.dev · mcp-server-taskwarrior (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.