Todos

Todos

A practical todo list manager to use with your favourite chatbot.

5
Stars
4
Forks
1
Releases

Overview

An MCP-enabled todo list application that demonstrates how AI models and chatbots can interact with external software via a standardized interface. It provides full CRUD functionality for tasks (create, read, update, delete) and exposes a set of MCP tools that allow AI assistants to manage and query todos. The app supports listing all tasks, listing by status (completed or pending), retrieving individual tasks by ID, adding new tasks, marking tasks as done, and listing due tasks (today, overdue, or this week). Available MCP endpoints include Get-Todo, List-All-Todos, List-Completed-Todos, List-Pending-Todos, Add-Todo, Update-Todo, Mark-Todo-Done, List-Due-Today, and List-Due-This-Week. Data is stored locally with no SaaS account required. The MCP integration enables natural language interactions with AI assistants, enabling commands like “show my pending tasks” or “mark task 123 as done.” The repository notes how to configure Claude by adding the 'todos' server to claude_desktop_config.json, underscoring its role as a practical MCP demonstration and a starting point for AI-friendly task apps.

Details

Owner
tomelliot
Language
TypeScript
License
GNU General Public License v3.0
Updated
2025-12-07

Features

Full CRUD Todo functionality

Provides complete create, read, update, and delete operations for tasks.

MCP-compliant API

Exposes MCP tools that enable AI assistants to manage and query todos through standard MCP endpoints.

Local storage

Stores all data locally in the user's environment without requiring a SaaS account.

Audience

DevelopersExperiment with integrating MCP-enabled task apps into AI assistants and chatbots.
AI assistant developersTest and demonstrate MCP endpoint interactions for task management workflows.
End usersManage personal tasks via natural language conversations with local, private storage.

Tags

todoMCPModel Context ProtocolAI assistant integrationlocal storageMCP toolsCRUDClaude integration