What is Intelliplan Mcp

IntelliPlan-MCP is an AI-powered task management system designed to enhance the development workflow by integrating with the Model Context Protocol (MCP) in Cursor AI and other compatible editors. It helps organize projects through a structured hierarchy of Epics, Tasks, and Subtasks.

Use cases

Use cases for IntelliPlan-MCP include managing large software projects, breaking down complex tasks into manageable pieces, tracking team progress, and providing contextual summaries to keep teams aligned on project goals.

How to use

To use IntelliPlan-MCP, simply interact with it using natural language commands within your coding environment. You can create and manage Epics, Tasks, and Subtasks, track progress, and receive AI-assisted suggestions without switching between tools.

Key features

Key features include Epic creation and management, task and subtask organization, smart dependencies, AI-assisted breakdown of tasks, complexity analysis, progress tracking, next action recommendations, and seamless integration with editors via the MCP protocol.

Where to use

IntelliPlan-MCP is suitable for software development projects, agile teams, and any environment where task management and project organization are essential. It is particularly useful in collaborative settings where clear communication of tasks is vital.

✨ IntelliPlan MCP

Your AI-powered Epic Planning Assistant for Cursor AI

🚀 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

# Set up your project storage
@IntelliPlanMCP manageItems action=configure basePath="/path/to/your/project"

# Create a new epic
@IntelliPlanMCP createEpic description="Build user authentication system with JWT"

# Add a task to your epic
@IntelliPlanMCP manageItems action=createTask epicId=your-epic-id description="Implement login endpoint"

# Get an overview of all your epics
@IntelliPlanMCP manageItems action=listEpics

# Create a complete epic with nested tasks in a single operation
@IntelliPlanMCP batchEpic description="Multi-tenant user authentication" basePath="/path/to/project" tasks=[...]

# Get an epic overview with specific diagram types
@IntelliPlanMCP getEpicOverview epicId=your-epic-id basePath="/path/to/project" diagramTypes=["progressPie", "dependencyGraph", "userJourney"]

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.

🔄 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

🛠️ 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"
         ]
       }
     }
   }
   

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:

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