todo-for-ai

# Todo for AI [](https://github.com/todo-for-ai/todo-for-ai/stargazers) [](https://github.com/todo-for-ai/todo-for-ai/blob/main/LICENSE) [](https://github.com/todo-for-ai/todo-for-ai/issues) [](https://github.com/todo-for-ai/todo-for-ai/network) [](https://www.npmjs.com/package/@todo-for-ai/mcp) [](https://hub.docker.com/r/todoforai/todo-for-ai) [](https://todo4ai.org) [中文版本](README_zh.md) | **English** 🚀 **A powerful task management system specifically designed for AI assistants**, supporting intelligent project management, automated task tracking, and seamless team collaboration through MCP (Model Context Protocol) integration. > 🚀 **Try it now**: Visit [https://todo4ai.org/](https://todo4ai.org/) to experience our product! ## 🤖 Why Todo for AI? **Todo for AI** bridges the gap between AI assistants and human productivity workflows. Unlike traditional task management tools, our system is built from the ground up to work seamlessly with AI agents through the Model Context Protocol (MCP). ### 🎯 **Core Value Propositions** - **🔗 Native AI Integration**: First-class support for AI assistants through MCP, enabling natural language task management - **🧠 Intelligent Automation**: AI agents can create, update, and manage tasks autonomously based on context and user needs - **📊 Smart Project Insights**: AI-powered analytics and recommendations for better project planning and execution - **🔄 Seamless Workflow**: Bridge between AI capabilities and human oversight with intelligent task delegation - **🌐 Universal Compatibility**: Works with Claude, GPT, and other AI assistants through standardized MCP protocol - **⚡ Real-time Collaboration**: Instant synchronization between AI agents and human team members ### 🚀 **Perfect For** - **AI-First Teams** building the future of work - **Developers** integrating AI assistants into their workflows - **Product Managers** coordinating between AI agents and human teams - **Researchers** managing complex AI-driven projects - **Anyone** looking to supercharge their productivity with AI assistance ## 📸 Screenshots & Demo ### 🖥️ **Web Interface** <div align="center">  *Modern, intuitive dashboard for project and task management*  *Comprehensive task management with AI integration*  *Seamless AI assistant integration through MCP* </div> ### 🎬 **Demo Video** [](https://www.youtube.com/watch?v=DEMO_VIDEO_ID) *Click to watch a full demo of Todo for AI in action* ### ✨ **Key Features in Action** - 🤖 **AI-Powered Task Creation**: Watch AI assistants create and organize tasks naturally - 📊 **Real-time Analytics**: See project progress and insights update live - 🔄 **Seamless Collaboration**: Experience smooth coordination between AI and human team members - 🎯 **Smart Prioritization**: Observe AI-driven task prioritization and scheduling ## 📁 Project Structure This project uses Git Submodule architecture, splitting different modules into independent repositories: - **todo-for-ai-api-server/**: Backend API server → [todo-for-ai-api-server](https://github.com/todo-for-ai/todo-for-ai-api-server) - **todo-for-ai-webpage/**: Frontend web application → [todo-for-ai-webpage](https://github.com/todo-for-ai/todo-for-ai-webpage) - **todo-for-ai-mcp/**: MCP server → [todo-for-ai-mcp](https://github.com/todo-for-ai/todo-for-ai-mcp) ## 🚀 Installation & Quick Start Choose your preferred installation method: ### 🐳 **Option 1: Docker (Recommended)** The fastest way to get started - everything included in one container: ```bash # Pull and run the latest image docker run -d --name todo-for-ai \ -p 50111:80 \ -p 50110:50110 \ -e DATABASE_URL="mysql+pymysql://username:password@host.docker.internal:3306/todo_for_ai" \ -e GMAIL_USER="your-email@gmail.com" \ -e GMAIL_PASSWORD="your-app-password" \ -e GITHUB_TOKEN="your-github-token" \ -e SECRET_KEY="your-secret-key-here" \ -e JWT_SECRET_KEY="your-jwt-secret-key-here" \ --add-host=host.docker.internal:host-gateway \ todoforai/todo-for-ai:latest # Access the application # Frontend: http://localhost:50111/todo-for-ai/page