TaskChampion MCP
Let your coding agent create, query, and update Taskwarrior 3.x tasks and Timewarrior time entries from the terminal workflow you already use.
Overview
TaskChampion MCP is a MCP server for the Build phase that lets agents manage Taskwarrior 3.x tasks and Timewarrior time entries through standardized tools.
What is this MCP server?
- Bridges Taskwarrior 3.x and TaskChampion sync semantics to MCP tools over stdio
- Exposes Timewarrior-compatible time tracking alongside task CRUD and filters
- Runs via uvx from PyPI package taskchampion-mcp v1.0.4
- Stdio transport for Claude Code, Cursor, and other MCP hosts
- Keeps local-first task data on disk instead of forcing a cloud PM tool
- Server version 1.0.4 on PyPI
- Stdio transport via package identifier taskchampion-mcp
- Targets Taskwarrior 3.x and TaskChampion replication
What problem does it solve?
Switching between your editor and taskwarrior CLI breaks flow when you want the agent to reprioritize or log time mid-session.
Who is it for?
Terminal-first indie hackers already running Taskwarrior 3.x who want MCP-driven task and time ops during coding.
Skip if: Teams on cloud-only Asana/Linear with no Taskwarrior install or appetite for local TW configuration.
What do I get? / Deliverables
Your agent can list, add, modify, and complete tasks and time blocks using the same local Taskwarrior database you trust.
- Agent-callable tools for Taskwarrior task operations
- Timewarrior-aligned time entry control from the agent
- Local backlog updates without switching to a web PM UI
Recommended MCP Servers
Journey fit
Task and time tracking sits in the build phase as the canonical shelf because solo builders wire agents into day-to-day execution and backlog management while shipping. PM subphase fits task prioritization, dependencies, and time boxing that mirror indie sprint rituals without a heavy SaaS PM stack.
How it compares
Taskwarrior-native MCP bridge, not a standalone project-management SaaS or generic notes skill.
Common Questions / FAQ
Who is TaskChampion MCP for?
Solo builders and developers who use Taskwarrior 3.x and optionally Timewarrior and want their AI agent to manipulate tasks without leaving the MCP session.
When should I use TaskChampion MCP?
Use it during build and operate rituals when you need the agent to triage your backlog, update task metadata, or record time against active work.
How do I add TaskChampion MCP to my agent?
Register the PyPI package with uvx as a stdio MCP server in Claude Desktop, Claude Code, or Cursor, then ensure Taskwarrior is installed and your data path is valid.