Todo List MCP

🚀 Todo List MCP Server

A Model Context Protocol (MCP) server that provides a comprehensive API for managing to-do lists.

📚 Learning Resources: This project serves as an educational example for MCP implementation. For detailed information about the project and how it's implemented, please refer to GUIDE.md.

✨ Features

• Create To-Do: Add a new task with a title and a description in Markdown format.
• Update To-Do: Modify an existing task.
• Complete To-Do: Mark a task as completed.
• Delete To-Do: Remove a task from the list.
• Search To-Do: Find tasks by title or creation date.
• Summarize To-Do: Get a quick overview of all active tasks.

🛠️ Tools

This MCP server exposes the following tools:

1. create-todo: Create a new to-do.
2. list-todos: List all to-dos.
3. get-todo: Get a specific to-do by ID.
4. update-todo: Update the title or description of a to-do.
5. complete-todo: Mark a to-do as completed.
6. delete-todo: Delete a to-do.
7. search-todos-by-title: Search for to-dos by title (case-insensitive partial match).
8. search-todos-by-date: Search for to-dos by creation date (format: YYYY-MM-DD).
9. list-active-todos: List all incomplete to-dos.
10. summarize-active-todos: Generate a summary of all active (incomplete) to-dos.

📦 Installation

# Clone the repository
git clone https://github.com/RegiByte/todo-list-mcp.git
cd todo-list-mcp

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Start the Server

npm start

Configuration in Claude for Desktop

Claude Desktop

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"]
    }
  }
}

Cursor

• Go to "Cursor Settings" -> "MCP".
• Add a new MCP server of type "Command Line".
• Add the absolute path of the server and run it with Node.
• Example: node /absolute/path/to/todo-list-mcp/dist/index.js

Example Commands

When used in conjunction with Claude for Desktop or Cursor, you can try the following commands:

• "Create a to-do to learn MCP and add a description explaining why MCP is useful."
• "List all my active to-dos."
• "Create a to-do for tomorrow's meeting and include the agenda details in Markdown format."
• "Mark my to-do of learning MCP as completed."
• "Summarize all my active to-dos."

📁 Project Structure

The project's code directory is as follows:

• models: Contains data models and database interaction logic.
• services: Provides implementations of core business functions.
• routes: Defines API routes and endpoints.
• utils: Contains helper functions and other utility modules.

📚 Documentation

This project is designed for educational purposes and provides a basic structure for learning MCP implementation. Developers can gain a deep understanding of the core concepts and technologies of MCP by reading the code, experimenting with the features, and exploring how it works.

🔨 Development

Build

npm run build

Run

npm start

📄 License

This project is licensed under the MIT License.