TaskWarrior MCP Server

MCP Server for TaskWarrior!

Catalog onlyCatalog onlySTDIO

Overview

TaskWarrior MCP Server is a Node.js server that implements the Model Context Protocol (MCP) for managing tasks in TaskWarrior, allowing users to interact with their task management system programmatically.

To use the TaskWarrior MCP Server, install it via npm, ensure TaskWarrior is installed and configured, and then configure your client to connect to the MCP server.

View pending tasks with filtering options by project and tags. - Add new tasks with detailed descriptions, due dates, priorities, and tags. - Mark tasks as complete through the API.

Integrating task management into custom applications.
Automating task updates and retrievals in personal productivity systems.
Enhancing team collaboration by managing shared tasks through a server interface.

Add to your AI client

Use these steps to connect TaskWarrior MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-taskwarrior-awwaiid": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-taskwarrior-awwaiid"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

Do I need to install TaskWarrior separately?

Yes! TaskWarrior must be installed and configured on your system to use this MCP server.

What programming language is this server built with?

The server is built using Node.js.

Is there a risk of task ID changes affecting my tasks?

Yes, task IDs can change when tasks are added or removed; it's recommended to use task UUIDs for stability.

Developer tools