Todos

What is todos-mcp?

todos-mcp is a todo list application that implements the Model Context Protocol (MCP). This allows AI assistants and chatbots to interact with and manage your todo list using natural language. It functions as a practical todo list manager and serves as a demonstration of MCP integration.

How to use todos-mcp?

To use todos-mcp, you need to configure your AI assistant (e.g., Claude) to recognize and interact with the application. This typically involves adding the todos-mcp server to your AI assistant's configuration file. Once configured, you can use natural language commands to manage your tasks through the AI assistant.

Key Features of todos-mcp

• Full todo list functionality: Create, read, update, and delete tasks.
• MCP-compliant API: Seamless integration with AI assistants and chatbots.
• Local storage: No need for a SaaS account; all data is stored locally.
• Comprehensive MCP Tools: Exposes various tools for AI interaction, including Get-Todo, List-All-Todos, List-Completed-Todos, List-Pending-Todos, Add-Todo, Mark-Todo-Done, List-Due-Today, List-Due-This-Week, and Update-Todo.

Use Cases of todos-mcp

• AI-powered Task Management: Manage your daily tasks and to-do items using voice commands or text input through your favorite AI assistant.
• Developer Tool: Serves as a practical example and development base for understanding and implementing the Model Context Protocol in other applications.
• Personal Productivity: A simple and effective way to keep track of personal and work-related tasks.

FAQ about todos-mcp

Q: What is MCP? A: The Model Context Protocol (MCP) is a standardized interface that enables AI models and chatbots to interact with applications in a consistent and predictable manner.

Q: Do I need a special account to use todos-mcp? A: No, todos-mcp uses local storage, so you don't need to create any SaaS accounts.

Q: Can I contribute to todos-mcp? A: Yes, contributions are welcome! You can submit Pull Requests to the project repository.

MCP Todo List App

A todo list application implementing Model Context Protocol (MCP), enabling seamless interaction with AI assistants and chatbots. This application is a practical todo list manager and a demonstration of MCP integration.

Features

• ✨ Full todo list functionality (create, read, update, delete tasks)
• 🤖 MCP-compliant API for AI assistant integration
• 🏠 Local storage (no SaaS account required)

What is MCP?

The Model Context Protocol (MCP) is a standardized interface that allows AI models and chatbots to interact with applications in a consistent and predictable way. By implementing MCP, this todo list app can be seamlessly controlled by AI assistants, enabling natural language interactions for task management.

Getting Started

1. Open Claude config file
2. Add the todos server to your claude_desktop_config.json (usually found at ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS)

{
  "mcpServers": {
    // ...
    "todos": {
      "command": "npx",
      "args": ["-y", "todos-mcp"]
    }
    // ...
  }
}

Development

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/tomelliot/todos-mcp.git
cd mcp-todo-app

2. Install dependencies:

npm install
# or
yarn install

3. Start the development server:

npm run dev
# or
yarn dev

MCP Integration

This todo list app exposes the following MCP tools:

• Get-Todo: Get a specific todo by ID
• List-All-Todos: List all todos
• List-Completed-Todos: List all completed todos
• List-Pending-Todos: List all pending todos
• Add-Todo: Add a todo
• Mark-Todo-Done: Mark a todo item as completed
• List-Due-Today: List all pending todos that are due today or overdue
• List-Due-This-Week: List all pending todos that are due this week or earlier
• Update-Todo: Update a todo's description and/or due date

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the GPL License - see the LICENSE file for details.

Acknowledgments

• Built with modern web technologies
• Implements MCP specification for AI integration
• Inspired by the need for AI-friendly applications