SimplePlan
🎯 The First AI-Native Project Management Tool with Universal AI Access
🚀 What is SimplePlan?
SimplePlan revolutionizes project management by enabling direct AI control over project plans. Unlike traditional tools where AI can only suggest actions, SimplePlan's Model Context Protocol (MCP) integration allows AI systems to:
- Create and manage project plans autonomously
- Track progress in real-time
- Add and complete project steps with dependency validation
- Optimize workflows based on project status
- Coordinate teams through intelligent step assignment
✨ Key Features
🧠 AI-Native Design
- 7 MCP Tools for complete project control via AI
- Universal AI Access through Claude Desktop and other MCP hosts
- Real-time Collaboration between humans and AI systems
📋 Comprehensive Project Management
- Dependency Validation ensures logical project flow
- Progress Tracking with completion percentages
- Step Management with types, assignments, and timestamps
- Project Validation catches errors before they cause problems
🔌 Modern Integration
- FastMCP Framework for efficient AI communication
- CLI Interface for manual project management
- JSON Storage for portable, version-controllable plans
- Rich Terminal UI for beautiful command-line experience
🛠️ MCP Tools Available
create_project_plan- Start new projects with AIget_project_status- Check progress and completionadd_project_step- Add work items with dependenciescomplete_step- Mark work done with validationget_next_steps- Find available work (no blockers)list_all_steps- Show complete project overviewvalidate_project_plan- Check for errors and issues
🚀 Quick Start
Installation
git clone https://github.com/bjornjohnson/SimplePlan.git
cd SimplePlan
poetry install
CLI Usage
# Create a new project
poetry run simpleplan create "My Web App" "Build a React todo application"
# Add project steps
poetry run simpleplan add "Set up development environment" --type setup
poetry run simpleplan add "Create React components" --type development --depends STEP-001
# Track progress
poetry run simpleplan status
poetry run simpleplan next
# Complete work
poetry run simpleplan complete STEP-001
MCP Integration (AI Access)
- Configure Claude Desktop with SimplePlan MCP server
- Ask AI to manage your projects directly
- Watch AI create, track, and optimize your project plans autonomously
See MCP_INTEGRATION.md for complete setup instructions.
📚 Documentation
- MCP Integration Guide - Complete setup and usage
- Usage Examples - Real-world AI scenarios
- Intellectual Property Guide - Ownership and protection
🎯 Why SimplePlan?
Before SimplePlan:
- AI: "You should run
npm install react" - Human: manually runs command
- AI: "Now create components..."
- Human: manually executes each suggestion
After SimplePlan:
- AI: directly creates project plan with React setup
- AI: adds development steps with proper dependencies
- AI: tracks progress as human completes work
- AI: suggests optimizations and next priorities
Result: Seamless human-AI collaboration instead of suggestion-based workflows.
🏗️ Architecture
Claude Desktop (Host)
↓ JSON-RPC 2.0 via stdio
SimplePlan MCP Server (FastMCP)
↓ Function calls
SimplePlan Core (project_plan_io.py)
↓ File operations
Project Plan JSON Files
🧪 Development
Setup
poetry install
poetry shell # Activate virtual environment
# Run tests
poetry run pytest
# Development commands
poetry run black . # Format code
poetry run ruff . # Lint code
poetry run isort . # Sort imports
poetry run mypy . # Type checking
Project Status
- Phase 1 Complete: Full CLI functionality with comprehensive tests
- Phase 2 Complete: MCP integration with 7 AI tools
- Current Status: 100% complete, production-ready
📄 License & Copyright
Copyright © 2025 Sunset Code Collaborative, LLC. All rights reserved.
Licensed under the MIT License. This means:
- ✅ Free to use for any purpose
- ✅ Free to modify and distribute
- ✅ Commercial use permitted
- ⚠️ Attribution required - must include copyright notice
- ⚠️ No warranty - use at your own risk
🤝 Contributing
SimplePlan is open to contributions! Please:
- Fork the repository
- Create a feature branch
- Add tests for new functionality
- Submit a pull request with clear description
All contributors must respect the copyright and licensing terms.
📞 Contact
Sunset Code Collaborative, LLC - Creator & Maintainer
- Contact: Bjorn Johnson, Member
- GitHub: @bjornjohnson
- Email: bjorn@sunsetcodecollaborative.com
🎉 Acknowledgments
- FastMCP - Excellent MCP framework for Python
- Claude Desktop - First-class MCP host implementation
- Model Context Protocol - Revolutionary AI integration standard
🏆 SimplePlan: Pioneering the future of AI-human project collaboration since 2025
Built with ❤️ and cutting-edge AI integration
Metadata
Release files for SimplePlan 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| simpleplan-1.0.3.tar.gz | 13.0 kB | Without provenance | Details for simpleplan-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| simpleplan-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for simpleplan-1.0.3-py3-none-any.whl |
Total release size: 26.4 kB
Release files / simpleplan-1.0.3.tar.gz
| Download URL | simpleplan-1.0.3.tar.gz |
|---|---|
| Size | 13.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4c52e3800fa3f823141814120118cb3b4832f9179239554049228812f1526fd5
|
|
BLAKE2b-256 checksum How to use checksums |
c078576bf5302b285b7382f2566edf336e42188ab8340022650776e66ce0c2e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.12.11 Linux/6.11.0-1018-azure
|
Release files / simpleplan-1.0.3-py3-none-any.whl
| Download URL | simpleplan-1.0.3-py3-none-any.whl |
|---|---|
| Size | 13.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bd37cfaf35a2485a9e3da18c71c36424253fbfb84d8358af67597fcab0de6762
|
|
BLAKE2b-256 checksum How to use checksums |
040c0b7a70053ff7f7dd0621251440a0b003aa15bd00bcd4e8c8d531d31de369
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.12.11 Linux/6.11.0-1018-azure
|
Security for SimplePlan 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.