TaskWarrior MCP Server

TaskWarrior MCP Server

MCP server for managing TaskWarrior tasks via a standardized protocol

View on GitHub
36
Stars
8
Forks
36
Watchers
4
Issues
Implements the Model Context Protocol (MCP) to provide a Node.js server interface for TaskWarrior operations. Allows viewing, filtering, adding, and completing tasks through a standardized API. Integrates with task management workflows by utilizing the local TaskWarrior client, supporting advanced task attributes like projects and tags. Enables seamless task manipulation for external tools such as Claude Desktop.

Key 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
Standardized MCP protocol API
Works with local TaskWarrior installation
Integration with Claude Desktop
Command-line interoperability
Provides example API usage documentation
Handles optional and required task attributes

Use Cases

Managing personal or work tasks remotely
Automating task workflows via standardized APIs
Integrating TaskWarrior with AI tools like Claude Desktop
Filtering and organizing tasks by project or tag
Adding new tasks with rich metadata
Marking tasks as completed from external interfaces
Building custom task dashboards with MCP compatibility
Syncing task lists with productivity tools
Facilitating team task tracking with protocol-based access
Experimenting with MCP standard for task management tools

README

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:

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.

Star History

Star History Chart

Repository Owner

awwaiid
awwaiid

User

Repository Details

Language JavaScript
Default Branch main
Size 55 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
100%

Tags

Task Management Node.js server productivity API

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Things MCP Server

    Things MCP Server

    Seamless Model Context Protocol integration for managing Things app todos and projects.

    Things MCP Server enables AI assistants to interact with the Things productivity app using the Model Context Protocol (MCP). It offers comprehensive support for Things' URL scheme, allowing creation, updating, and management of todos and projects through standardized commands. The server supports batch operations, advanced organization features, and natural language scheduling, making task automation efficient for MCP-compatible clients.

    • ⭐ 6
    • MCP
    • jimfilippou/things-mcp
  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • ⭐ 35
    • MCP
    • jen6/ticktick-mcp
  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • ⭐ 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • MCP Server for Asana

    MCP Server for Asana

    Bridge Asana's API with Model Context Protocol tools for seamless task management.

    MCP Server for Asana provides a Model Context Protocol (MCP) compliant interface to the Asana API, enabling direct interaction with Asana from MCP clients such as Claude Desktop. It offers tools to list, search, retrieve, and create tasks and projects within Asana workspaces, with options for both read and write operations. The server supports advanced task filtering, project searching, and read-only modes for secure testing. Integration facilitates automation and streamlined project management within AI-powered environments.

    • ⭐ 107
    • MCP
    • roychri/mcp-server-asana
  • Notion MCP Integration

    Notion MCP Integration

    Integrate your minimal Notion todo list with Claude via Model Context Protocol.

    Notion MCP Integration provides a simple MCP server that enables users to manage a minimalist Notion todo list through Claude, leveraging Notion's API. It supports adding, viewing, and completing tasks according to a specific Notion database structure. Designed for personal use, it allows users to interact with their tasks using natural language through Claude Desktop. The tool is easily customizable for different Notion databases by modifying the server implementation.

    • ⭐ 202
    • MCP
    • danhilse/notion_mcp
  • notion-mcp

    notion-mcp

    An MCP server for managing Notion to-do lists via API integration.

    notion-mcp provides a Model Context Protocol (MCP) server that connects with Notion's API to help users manage their personal to-do lists. It enables querying, adding, and updating tasks directly from Notion through a standardized MCP interface, and is designed for integration with tools like Claude Desktop. The project is set up for easy deployment via Smithery and supports OAuth credentials and per-user configuration.

    • ⭐ 27
    • MCP
    • Badhansen/notion-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results