TaskChampion MCP

by GabiUp2

2 stars

101 downloads

Not rated

GitHub Website

About

MCP server for Taskwarrior 3.x, TaskChampion, and Timewarrior task management with 35 tools for full task lifecycle, schema validation, role-based permissions, and time tracking.

Details

Author: GabiUp2
GitHub stars: 2
Downloads: 101
Categories: Other, Productivity, Project Management

- Three cumulative permission roles: CONTRIBUTOR, GENERATOR, MANAGER
- Bundled task schema presets (minimal, gtd, scrum, kanban, custom)
- No shell execution – subprocess argument lists only
- Input sanitization and configurable rate limiting
- Full audit logging with timestamp and result code
- Dry-run mode and confirmation tokens for destructive operations
- Sensitive field redaction in LLM responses

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name TaskChampion MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

From the repository

Install via pip install taskchampion-mcp or uv tool install taskchampion-mcp, then configure your IDE’s MCP settings to use the command taskchampion-mcp-server with no arguments. On first run, the server boots in onboarding mode; you must set role and schema/schema_path in ~/.config/taskchampion-mcp/config.toml — either through an LLM-driven walkthrough, the CLI wizard (./dev.sh init), or by hand-editing the config.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "taskchampion mcp": {
            "taskchampion": {
                "command": "uvx",
                "args": [
                    "taskchampion-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "taskchampion": {
        "command": "uvx",
        "args": [
            "taskchampion-mcp"
        ]
    }
}

TaskChampion MCP

A Model Context Protocol server for Taskwarrior 3.x, TaskChampion, and Timewarrior.

> For the bearded Unix jockeys and keyboard cowboys who manage their life from the terminal — and now want their LLM to lend a hand. 🧔⌨️

Latest release: v1.0.4 — pip install taskchampion-mcp / uvx taskchampion-mcp

---

What Is This?

TaskChampion MCP is a Model Context Protocol server that lets LLMs read, create, modify, and manage your Taskwarrior tasks and Timewarrior time entries. It wraps the task and timew CLI tools and exposes them as structured MCP tools that any compatible AI assistant can call.

Why? The author self-hosts TaskChampion on a home server and wanted a clean way for LLMs to cooperate on project planning, task decomposition, and time tracking — without giving up control of the task database.

---

Supported Platforms

| Platform | Transport | Status |
|---|---|---|
| Neovim (via Claude Code CLI) | stdio | v1.0.4 |
| Cursor | stdio | v1.0.4 |
| Windsurf | stdio | v1.0.4 |
| VS Code (Copilot MCP) | stdio | v1.0.4 |
| Claude Desktop | stdio | v1.0.4 |
| HTTP/SSE transports | HTTP/SSE | Deferred to v1.x |

Requirements:
- Python 3.10+
- Taskwarrior 3.x (TaskChampion sync)
- Timewarrior (optional, for time tracking features)

---

Quick Install

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

TaskChampion MCP

What Is This?

Supported Platforms

Quick Install

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

GitLab