{"id":"c546b186-0a11-4f69-a529-2c3a09d60d7f","slug":"tomelliot-todos-mcp","kind":"mcp","name":"todos-mcp","summary":"A todo list application implementing Model Context Protocol (MCP)","owner":"tomelliot","repoUrl":"https://github.com/tomelliot/todos-mcp","license":"GPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":6,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-04-08T09:13:22.000Z","addedAt":"2026-10-14T05:56:10.882Z","logoUrl":"https://avatars.githubusercontent.com/u/3267684?u=396610b6b0382ce652cb977cacaa7038c6b6255c&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["productivity","memory-knowledge"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T01:43:38.797Z","sample":false,"url":"https://conduits.dev/tools/tomelliot-todos-mcp","language":"TypeScript","transports":["stdio"],"install":{"npm":"todos-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# MCP Todo List App\n\nA 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.\n\n## Features\n\n- ✨ Full todo list functionality (create, read, update, delete tasks)\n- 🤖 MCP-compliant API for AI assistant integration\n- 🏠 Local storage (no SaaS account required)\n\n## What is MCP?\n\nThe 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.\n\n## Getting Started\n\n1. Open Claude config file\n2. Add the `todos` server to your `claude_desktop_config.json` (usually found at `~/Library/Application Support/Claude/claude_desktop_config.json` on MacOS)\n\n```json\n{\n  \"mcpServers\": {\n    // ...\n    \"todos\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"todos-mcp\"]\n    }\n    // ...\n  }\n}\n```\n\n## Development\n\n### Prerequisites\n\n- Node.js (v16 or higher)\n- npm or yarn\n\n### Installation\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/tomelliot/todos-mcp.git\ncd mcp-todo-app\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Start the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\n## MCP Integration\n\nThis todo list app exposes the following MCP tools:\n\n- `Get-Todo`: Get a specific todo by ID\n- `List-All-Todos`: List all todos\n- `List-Completed-Todos`: List all completed todos\n- `List-Pending-Todos`: List all pending todos\n- `Add-Todo`: Add a todo\n- `Mark-Todo-Done`: Mark a todo item as completed\n- `List-Due-Today`: List all pending todos that are due today or overdue\n- `List-Due-This-Week`: List all pending todos that are due this week or earlier\n- `Update-Todo`: Update a todo's description and/or due date\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the GPL License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built with modern web technologies\n- Implements MCP specification for AI integration\n- Inspired by the need for AI-friendly applications\n"}