Taskwarrior MCP Server

MCP server for taskwarrior

Local serverstdio

What is the Taskwarrior MCP Server?

Taskwarrior becomes available to MCP clients through the taskwarrior mcp server. MCP server for taskwarrior.

What Taskwarrior does

Node.js server implementing Model Context Protocol (MCP) for TaskWarrior operations.

Key capabilities

  • View pending tasks
  • Filter tasks by project and tags
  • Add new tasks with descriptions, due dates, priorities, projects and tags
  • Mark tasks as complete

Practical notes

  • Maintained by awwaiid.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_next_tasksGet a list of all pending tasks
projectProject name (lowercase with dots)
tagsArray of tags (lowercase)
add_taskAdd a new task to TaskWarrior
Required:identifier: Task ID or UUID
Optional:due: Due date (ISO timestamp)
priorityPriority level ("H", "M", or "L")
mark_task_doneMark a task as completed

How to install the Taskwarrior MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Taskwarrior to get next tasks.”
  • “Use Taskwarrior to project.”
  • “Use Taskwarrior to tags.”

Frequently asked questions

MCP server for taskwarrior Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.