taskmajor 1.0.0rc4

TaskMajor MCP. Coordinate your tasks. Execute with precision.

TaskMajor — Tailored MCP Workflows for AI Agents

Your tasks. Your method. Your agents.

TaskMajor connects your AI assistants to your task management—organized your way, hosted on your terms.

Ask your assistant:

"Add a task to review the API spec"
"What's on my plate for today?"
"Run my daily review"
"Show me the roadmap for Project X"

Why TaskMajor?

TaskWarrior is powerful but CLI-only. TaskMajor gives AI agents native access to its engine, and the profile system lets you shape the interaction model to match your methodology rather than the other way around. Behind this sits TaskWarrior—a remarkably flexible, battle-tested task engine. It runs locally, stores plain text, and bends to almost any organizational style. TaskMajor builds on that foundation and adds its own layer of adaptability: the profile system. Each profile defines a unique contract of exposed tools, views, and behaviors—turning TaskMajor into anything from a simple to-do list to a full GTD system or a multi-agent coordination hub. Explore the built-in profiles or learn how to compose and extend them in the profile documentation.

Ready to transform your task management? Jump straight into the Quick Start to get running in minutes.

🚀 Quick Start

pip install taskmajor
taskmajor

The server starts at http://localhost:8888. Point your AI agent at it.

That's it. TaskMajor bundles an embedded TaskWarrior engine (no external TaskWarrior binary required).

---

Go further:

• 📦 Installation options — uv, Docker, from source

• ⚙️ Configuration & CLI — workspace dir (-c), config file, all flags

• 🎭 Profiles — GTD, project management, or your own workflow

  taskmajor --profile standard      # default: task CRUD + agenda
  taskmajor --profile productivity  # GTD: reviews, energy levels, contexts
  taskmajor --profile project-mgmt  # sprints, blockers, effort tracking
  

📚 Documentation

Section	For
Agent configuration	Consult your agent's MCP documentation
Getting Started	DevOps / Deployment
API Reference	Developers / Integrators
Architecture	System design and concepts
Configuration	Environment variables and setup
Profiles	Workflow methodologies & custom profiles
Docker: Custom Profiles	Mount profiles without overwriting built-ins
Troubleshooting	Common issues and solutions
Contributing	Development guidelines & pull requests

🌐 Community

• Issues & Features: GitHub Issues
• Discussions: GitHub Discussions

---

📄 License

MIT License — See LICENSE for details.

---

🏗 Acknowledgments

Built with:

• FastMCP — Modern MCP framework
• pytaskwarrior — Python bindings for TaskWarrior / TaskChampion
• taskchampion3-py-dev — Embedded TaskChampion engine (PyO3/Rust, no external binary needed)
• Pydantic — Data validation
• OpenTelemetry — Observability

---