Skip to main content

SimplePlan

🎯 The First AI-Native Project Management Tool with Universal AI Access

Python License: MIT MCP Compatible Tests Publish

🚀 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

  1. create_project_plan - Start new projects with AI
  2. get_project_status - Check progress and completion
  3. add_project_step - Add work items with dependencies
  4. complete_step - Mark work done with validation
  5. get_next_steps - Find available work (no blockers)
  6. list_all_steps - Show complete project overview
  7. validate_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)

  1. Configure Claude Desktop with SimplePlan MCP server
  2. Ask AI to manage your projects directly
  3. Watch AI create, track, and optimize your project plans autonomously

See MCP_INTEGRATION.md for complete setup instructions.

📚 Documentation

🎯 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

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:

  1. Fork the repository
  2. Create a feature branch
  3. Add tests for new functionality
  4. Submit a pull request with clear description

All contributors must respect the copyright and licensing terms.

📞 Contact

Sunset Code Collaborative, LLC - Creator & Maintainer

🎉 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)

Source distribution for SimplePlan 1.0.3
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)

Table of built distributions (wheels) for SimplePlan 1.0.3
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.0.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page