IntelliPlan

✨ IntelliPlan MCP

🚀 Transform Your Development Workflow

IntelliPlan is an intelligent task management system that seamlessly integrates with the Model Context Protocol (MCP) in Cursor AI and other compatible editors. It empowers you to organize your development process with a structured Epic → Task → Subtask hierarchy, all without leaving your coding environment.

✅ What Can IntelliPlan Do For You?

Organize Complex Projects with Ease

• Epic Creation & Management - Break down complex projects into manageable high-level goals
• Task & Subtask Organization - Structure your work with clear parent-child relationships
• Smart Dependencies - Define and track relationships between work items

Supercharge Development Planning

• AI-Assisted Breakdown - Automatically split complex tasks into manageable pieces
• Smart Implementation Suggestions - Get guidance on how to approach challenges
• Complexity Analysis - Understand the effort required before diving in

Keep Your Team on Track

• Progress Tracking - Monitor completion status across all levels
• Next Action Recommendations - Always know what to work on next
• Contextual Understanding - Get summaries that capture the full scope of work

Seamless Editor Integration

• Natural Language Interface - Interact with IntelliPlan using conversational commands
• Stay in Your Workflow - No need to switch context between tools
• MCP Protocol Support - Works with any editor that implements the Model Context Protocol

📋 Available Tools

IntelliPlan provides a suite of powerful tools to manage your development process:

🎮 Usage Examples

Available Diagrams 🚧

Note: The diagram functionality is currently a Work In Progress (WIP) 🚧

The getEpicOverview tool supports various Mermaid diagram types to visualize your epic's structure and progress:

You can specify which diagrams to include using the diagramTypes parameter array. If not specified, all diagram types will be included when includeDiagrams is set to true.

🐳 Docker Deployment

IntelliPlan can be deployed using Docker for easy setup and management. The Docker deployment supports both local and remote storage modes.

Building the Docker Image

Running with Docker

Storage Configuration Options

IntelliPlan supports two storage modes when running in Docker:

1. Remote Mode (Default)

In remote mode, files are stored in a persistent volume mounted to the /data directory in the container:

This is the recommended configuration for Docker deployments. All data will be stored in the .intelliplan-data directory on the host machine.

2. Local Mode

If you prefer to use local storage mode, you can override the environment variables:

Docker Compose Example

For easier management, you can use Docker Compose:

Save this as docker-compose.yml and run with:

🔄 Remote Server Mode

IntelliPlan now supports a remote server mode, allowing you to store your epics and tasks on a centralized server instead of directly on your local filesystem. This enables team collaboration and access to your planning data from multiple devices.

📡 Setting Up the Remote Server

1. Start the API Server:
   # Set environment variables for configuration or use defaults npm run start:api
2. Environment Variables for the API Server:
   • PORT: Port to run the server on (default: 3000)
   • STORAGE_PATH: Location where the API server will store data (default: current directory)

🔌 Connecting to a Remote Server

1. Simple Configuration:At minimum, you only need to set:
   STORAGE_MODE=remote
   This will connect to a server running on http://localhost:4007 by default.
2. Advanced Configuration (optional):
   STORAGE_MODE=remote REMOTE_API_URL=http://your-server:4007 # Custom server URL REMOTE_API_KEY=your-api-key # If authentication is enabled
3. Start IntelliPlan in remote mode:
   npm run dev
4. Configure in Cursor: Add to your .cursor-settings.json:
   { "mcpServers": { "IntelliPlanMCP": { "command": "node", "args": ["path/to/dist/index.js"], "env": { "STORAGE_MODE": "remote" } } } }

🛡️ Security Considerations

• The API server includes basic rate limiting and CORS protection
• For production use, consider adding:
  • HTTPS encryption
  • Strong authentication
  • More robust input validation
  • Backup solutions for your data

📋 Epic Management with listEpics

The new listEpics tool provides a convenient way to view and manage all available epics in your IntelliPlan workspace.

🔍 Filtering and Sorting Options

The listEpics tool supports the following parameters:

📊 Output Format

The tool returns a formatted table with the following columns:

• Epic ID
• Description
• Status (with visual indicators)
• Task completion (completed/total)
• Completion percentage

🚀 Example Usage

Basic usage:

With filtering and sorting:

When storage is not configured:

🛠️ Getting Started

1. Install IntelliPlan:
   npm install npm run build
2. Configure in Cursor: Add to your .cursor-settings.json:
   { "mcpServers": { "IntelliPlanMCP": { "command": "node", "args": ["path/to/dist/index.js"], "env": { "STORAGE_MODE": "remote" } } } }
3. Enable & Start Planning: Activate MCP in your editor settings and start organizing your development process!

📝 Customizing Planning Process

IntelliPlan supports customizable planning processes through JSON configuration files:

1. Create Configuration Files: You can place JSON configuration files anywhere in your project. The config/planning/ directory is suggested for organization, but not required. See config/sample-planning-config.json for an example.
2. Using the Configuration Builder: IntelliPlan provides an interactive tool to create planning configurations:
   @IntelliPlanMCP createPlanningConfig currentStep=0
   This will guide you through a step-by-step process to define your custom planning steps.
3. Direct Configuration Creation: For more advanced users, you can create a configuration directly:
   @IntelliPlanMCP createDirectPlanningConfig name="Custom Plan" description="Your custom planning process" outputPath="config/your-config.json" steps=[...]
4. Configuration Structure:
   { "id": "your-plan-id", "name": "Your Plan Name", "description": "Description of your planning process", "version": "1.0", "defaultMaxDepth": 3, "includeTestStrategy": true, "steps": [ { "id": "step-id", "name": "Step Name", "description": "Step description", "order": 0, "instructions": ["Instruction 1", "Instruction 2"], "thinkingPrompts": ["Thinking prompt 1", "Thinking prompt 2"], "nextStepPrompt": "Guidance for the next step", "requiresPreviousStepData": false } // Additional steps... ] }
5. Use Custom Configuration:
   @IntelliPlanMCP planEpic description="Your project" configPath="full/path/to/your/config.json"
6. LLM-Generated Configurations: The configuration path doesn't have to point to an existing file. The language model can generate custom planning configurations on-the-fly based on your requirements. Simply ask the LLM to create a planning configuration for your specific needs, and it will generate the appropriate JSON configuration for your use case.

🔍 Why IntelliPlan?

Unlike traditional task managers that live outside your development environment, IntelliPlan works right where you code. This integration eliminates context switching and keeps your planning tightly coupled with implementation.

IntelliPlan's AI capabilities go beyond simple task tracking - it understands the structure of your project and provides intelligent suggestions for implementation, testing strategies, and complexity analysis.

📄 License

MIT