Skip to main content
Glama

TaskWarrior MCP Server

by awwaiid

TaskWarrior MCP Server

Node.js server implementing Model Context Protocol (MCP) for TaskWarrior 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:

{ "mcpServers": { "taskwarrior": { "command": "npx", "args": [ "-y", "mcp-server-taskwarrior" ] } } }

Installation

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.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Node.js server implementing Model Context Protocol that enables interaction with TaskWarrior through natural language to view, filter, add, and complete tasks.

  1. Features
    1. API
      1. Tools
    2. Usage with Claude Desktop
      1. Installation
        1. Example usage ideas:
          1. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.
              Last updated -
              7
              4
              JavaScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              A TypeScript Model Context Protocol server that integrates with Google Tasks API, allowing users to create, list, update, delete, and toggle completion status of tasks.
              Last updated -
              4
              5
              JavaScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.
              Last updated -
              4
              Python
              MIT License
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              A task management Model Context Protocol server that helps break down user requests into manageable tasks with subtasks, dependencies, and notes, while enforcing a structured workflow with user approval steps.
              Last updated -
              17
              54
              10
              JavaScript
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/awwaiid/mcp-server-taskwarrior'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server