📋 project-planner-MCP

A Model Context Protocol (MCP) server for AI-powered project and task management — create projects, manage todos, track priorities, and monitor progress seamlessly through any MCP-compatible AI assistant.

📖 Table of Contents

• Overview

• Features

• Getting Started

  • Prerequisites

  • Installation

  • Configuration

• Usage

  • Available Tools

  • Examples

• Integration with Claude

• Project Structure

• Contributing

• License

Related MCP server: Todoist MCP Server

🌟 Overview

project-planner-ai-MCP is a lightweight, AI-native project management server built on the Model Context Protocol (MCP). It allows AI assistants like Claude to create and manage projects and todos on your behalf — directly from natural language conversations, with no manual UI required.

Whether you're planning a software project, organizing tasks, or tracking team progress, project-planner-ai-MCP bridges the gap between your AI assistant and your project management workflow.

✨ Features

• 🗂 Project Management — Create, retrieve, and delete projects

• ✅ Todo Management — Add, update, and delete todos within projects

• 🔴 Priority Levels — Assign high, medium, or low priority to every task

• 📊 Status Tracking — Track todos as pending, in-progress, or completed

• 🤖 AI-Native — Fully operable through any MCP-compatible AI assistant

• ⚡ Lightweight — Minimal dependencies, fast setup

🚀 Getting Started

Prerequisites

• Node.js v24 or higher

• An MCP-compatible AI client (e.g., Claude Desktop)

Installation

Clone the repository:

git clone https://github.com/Enockkipkoech/project-planner-MCP.git
cd project-planner-ai-MCP

Install dependencies:

npm install

Build the project:

npm run build

Configuration

Add the server to your MCP client configuration file (e.g., claude_desktop_config.json):

{
	"mcpServers": {
		"project-planner-mcp": {
			"command": "node",
			"args": ["/absolute/path/to/project-planner-MCP/build/index.js"]
		}
	}
}

Restart your MCP client and the server will be available.

🛠 Usage

Available Tools

Examples

Create a project:

"Create a new project called E-Commerce Application"

Add todos:

"Add a high priority todo for User Authentication to my E-Commerce project"

Update status:

"Mark the Shopping Cart todo as in-progress"

List all todos:

"Show me all pending todos for the E-Commerce Application"

🤝 Integration with Claude

project-planner-MCP works seamlessly with Claude Desktop and Claude.ai via the MCP connector system. Once configured:

1. Open Claude Desktop

2. Start a conversation — Claude will automatically detect the available tools

3. Ask Claude to manage your projects in plain English

No extra commands or syntax required — just talk to your AI assistant naturally.

📁 Project Structure

project-planner-MCP/
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── tools/            # Tool definitions and handlers
│   └── storage/          # Data persistence layer
├── build/                # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤲 Contributing

Contributions are welcome! To get started:

1. Fork the repository

2. Create a new branch: git checkout -b feature/your-feature-name

3. Make your changes and commit: git commit -m "Add your feature"

4. Push to your branch: git push origin feature/your-feature-name

5. Open a Pull Request

Please make sure your code follows the existing style and includes relevant tests.

📄 License

This project is licensed under the MIT License. © 2026 Enock Kipkoech. All rights reserved.