taskmajor 0.3.3rc2

TaskMajor MCP. Coordinate your tasks. Execute with precision.

TaskMajor — Manage Tasks with Any AI Agent

TaskMajor MCP. Coordinate your tasks. Execute with precision.

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"

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 — see Agent Configuration for copy-paste snippets for Claude, Copilot, Cursor, and others.

That's it. TaskMajor bundles its own TaskWarrior engine — no binary to install.

---

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	Copilot, Claude Code, Cursor, Hermes
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	Add a new agent integration

🌐 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

---